News for hackers. Stuff that matters.

A comment on Ask HN: What is your go-to example for a good REST API?.

Re:Ask HN: What is your go-to example for a good REST API? by w8wut on Friday June 24, 2016 @02:02PM (#11971999)
http://developer.okta.com/docs/api/getting_started/design_pr...

Good error handling, easy to get started, and they provide Postman collections for each API

[ Parent | on HN ]
Re:Ask HN: What is your go-to example for a good REST API? by strictnein on Friday June 24, 2016 @03:41PM (#11972818)
Nice stuff.

One nitpick: it always feel weird to me to have an error (or any other object) where the attributes are named like this:

    {
        "errorCode": "E0000001",
        "errorSummary": "Api validation failed",
        "errorLink": "E0000001",
        "errorId": "oaeHfmOAx1iRLa0H10DeMz5fQ",
        "errorCauses": [
            {
                "errorSummary": "login: An object with this field already exists in the current organization"
            }
        ]
    }
Why have "error" in there at all?
[ Parent | on HN ]
Re:Ask HN: What is your go-to example for a good REST API? by dpcx on Friday June 24, 2016 @04:06PM (#11973009)
To make it absolutely obvious everywhere in your code that you're talking about an errorSummary, not just a summary?
[ Parent | on HN ]