• umbraroze@kbin.social
      link
      fedilink
      arrow-up
      32
      ·
      1 year ago

      /serious Well, yes, most APIs are meant for system-to-system interaction, that’s kind of a given. But since this particular API is clearly meant for human-to-system interaction, returning a human-readable response is adequate. Yes, a better design would probably allow the client to specify additional parameters about the desired response.

      /back-to-jokes Yeah, well this kind of sums up most of my job applications. I send an application and the recruiting people are all like “OK”.

    • penguin@sh.itjust.works
      link
      fedilink
      arrow-up
      1
      ·
      1 year ago

      That’s better than some I’ve seen. Like 200 for everything and the text could even be “error”.

      Or 500 with the text “invalid input”

    • deejay4am@lemmy.world
      link
      fedilink
      English
      arrow-up
      1
      ·
      1 year ago

      I also notice that the job you apply for seems to be a different value than what is displayed on the page. Seems like the documentation needs updating as well 😔