I suggest you ...

Hypermedia APIs

Have you guys done any work on hypermedia APIs? Specifically I'm implementing an API that uses HAL (json+hal) with features such as links to other resources and 'profile' properties. These hypermedia formats potentially open up a way to automate some pretty sophisticated documentation capabilities. I'm not sure how this factors into what kinds of capabilities you could support in the future and it's probably not widely used yet but it's something to think about going forward. There are other competing formats like collection+json, jsonapi.org, to consider as well.

2 votes
Vote
Sign in
Check!
(thinking…)
Reset
or sign in with
  • facebook
  • google
    Password icon
    I agree to the terms of service
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    Anonymous shared this idea  ·   ·  Admin →

    1 comment

    Sign in
    Check!
    (thinking…)
    Reset
    or sign in with
    • facebook
    • google
      Password icon
      I agree to the terms of service
      Signed in as (Sign out)
      Submitting...
      • Lukas LinhartAdminLukas Linhart (Admin, apiary.io) commented  · 

        Hi,

        before diving in: what specific features you think would help you?

        How could Apiary help you with hypermedia/HATEOAS?

        Regards,

        Lukas

      Feedback and Knowledge Base