• jballs@sh.itjust.works
    link
    fedilink
    English
    arrow-up
    1
    ·
    4 months ago

    Maybe this makes me old, but I much prefer a written document explaining how an API works over Swagger.

    • jcg@halubilo.social
      link
      fedilink
      arrow-up
      2
      ·
      4 months ago

      I prefer a hybrid approach. A document explaining some common things to do and generally the idea behind why the API is structured that way (shows me you actually thought about it, and makes it more logical to find different parts of it without necessarily looking it up), and then an API spec showing all the parameters.