EdwardHinkle · GitHub

Discussion for adding a way to query a list of posts from the Micropub endpoint (https://indieweb.org/Micropub-extensions#Query_for_Post_List)

Below are some thoughts from the brainstorming page.

Use Cases

  • [[headless_CMS|headless cms]] / Separation of data storage and data display
  • Private note taking / journaling
  • Find and update existing posts eg. change a "want to read" to "read" after complete
  • Full content management UIs
  • Find and edit draft / hidden posts
  • Synchronizing various documents eg. bookmarks
  • Discover if a user has liked / replied to a specific page

Query Parameters

In order to achieve the above use cases there would need to be a robust query system in place. It would need to be able to query for:

  • url (this filters and returns the single post with that url. This is how q=source currently functions)
  • posts based on post type (similar to Query for supported vocabulary #1)
  • pages of posts with defined limits
  • posts with specific properties
  • posts with combinations of properties
  • posts without certain properties
  • posts with properties that match a certain value (eg, all posts that have in-reply-to == 'example.com')

Other Considerations

  • Any returned item in a list would need to include a url property so that micropub clients could use the url for update and delete requests etc.
  • Would require one or more scopes

Read the original on github.com ↗