Another post from me as I continue to work through endpoints. This endpoint is present in 1.1, but it is undocumented. AFAIK, only Boost has made use of it so far, so this might be of particular relevance for them. The updated swagger is available here for your perusal. If you have already experimented with this endpoint from 1.1, I have included the changelog below. So far, this is the only feed endpoint in the api, documented or otherwise. I am sure more will be added in the future.

This is still open for feedback/suggestions, so if there is something here that would help/hurt, please let me know!

Changes from 1.1:

  • drop machine_name field as it was redundant with name field
  • rename num_communities to communities_count to better align with other counts fields for other endpoints
  • drop ap_id and ap_profile_id fields in favor of…
  • new actor_id field is the url of the activitypub actor (examples: https://instance.tld/f/feed_name for a public feed or https://instance.tld/f/feed_name/user_name for a private feed)
  • new ap_domain is the instance domain of the actor (example: piefed.social)
  • rename show_posts_in_children to show_posts_from_children. This is purely a linguistic preference on my part and so I am taking the opportunity before this endpoint gets more widely used, to change it now.
  • drop version field as it was not really informative
  • new local field that is a boolean indicating whether the feed is local or remote
  • wjs018@piefed.wjs018.xyzOP
    link
    fedilink
    English
    arrow-up
    4
    ·
    4 days ago

    Just wanted to ping @rmayayo@lemmy.world to let you know about these tweaks since I know you are using the 1.1 version of this endpoint (I think Boost is the only app I saw using feeds, but I can’t claim to have tested all of them).