REST-API-Grundlagen

Teil des Web-Kurses

Du sollst eine bestehende API um einen Endpunkt erweitern und bleibst schon bei der ersten Entscheidung hängen: heißt es POST /users/42/deactivate oder PATCH /users/42? Beides funktioniert. Beides geht in Produktion. Aber eines davon liest sich für die nächste Person selbstverständlich, und das andere löst im Code-Review eine Diskussion aus.

Stell dir einen Aktenschrank vor. Jede Schublade und jeder Ordner hat eine Adresse, und die Adresse sagt nie, was du dort vorhast. Das Tun ist eine eigene Entscheidung: lesen, ersetzen, wegwerfen. REST teilt eine API genauso auf. Die URL ist die Adresse eines Dings. Die HTTP-Methode ist das Verb. ...