API questions about photo collections

[samgrover]

Just learned of the new Photo Collections feature and looked over the help page about it. I had some questions about the API:

• Is there an API for the list of photos in a collection?
• Is there a way to re-order a collection, whether a UI or an API, or both?
• If a photo is added twice, does it show up as a duplicate?
• Does the photo need to be hosted on the same domain as the collection?

I could test some of these but thought best to ask to understand intended uses.

Thanks!

[jsonbecker]

Photo collections

Collections are a way to organize multiple photos and embed them into a blog post or standalone web page on Micro.blog. Collections can span across multiple blog posts and categories. Collections are just for photos. You might create collections to group together photos from a trip, or for a particular subject that you often capture in photos. When photos are added to a collection, all of those photos can be embedded in a new page by using a special shortcode with the collection name. If we ha…

This post details the API as it exists.

[samgrover]

Yes, I read that document and that’s what raised these questions.

[manton]

Hi @samgrover! Looks I missed a couple things in the documentation. Yes, to get all the photos in a collection, pass a new microblog-collection to the /micropub/media?q=source endpoint. The collection is the URL returned from the list of collections:

GET /micropub/media?q=source&mp-destination=...&microblog-collection=https://example.org/collections/1

You can’t add a photo twice to a collection. The photo URL has to exactly match the primary photo URL returned from /micropub/media?q=source. It can’t be a CDN or an external URL. It has to be the photo URL as Micro.blog knows about it.

Let me know if you have any other questions!

[samgrover]

@manton Thanks!