heide/api-werkstatt

LetsMeet · Profile-Service

A0 · Blackbox-Erkundung

Eine fremde API lesen lernen

Vorhersagen festhalten, echte Requests in IntelliJ ausführen und aus den Responses den veröffentlichten Vertrag rekonstruieren.

1A

Collection entdecken

Welche Form hat ein Profil?

GET /api/v1/profiles

Eine Vermutung genügt. Sie wird nicht auf Richtigkeit geprüft.

1B

Collection → Detail

Was bleibt beim Einzelprofil gleich?

GET /api/v1/profiles/p-100

Beziehe dich auf das, was du gerade in der Collection gesehen hast.

1C–D

Transfer statt Wiederholung

Trägt dasselbe Muster auch beim Hobbykatalog?

GET /api/v1/hobbiesGET /api/v1/hobbies/lesen

Eine gemeinsame Vorhersage für Collection und Detail genügt.

2A–B

Contrasting Cases

Zwei Fehler, zwei Ursachen

…/profiles/not-a-real-profile…/profiles/INVALID_ID

Sage beide Fälle voraus, bevor du einen der Requests ausführst.

3

Grenzprobe

Was passiert beim Schreiben?

POST /api/v1/profiles

Lege dich vor dem Request fest.

4

Eigenes Experiment

Bilde selbst einen Detailpfad

GET /api/v1/profiles/{{chosenProfileId}}

Notiere ID, Anzeigename und Hobbys gemeinsam – diese Vorhersage bleibt stehen.

5–6

Vertrag sichern

Was veröffentlicht dieser Service – und was nicht?

Keine neuen Statuscodes: Jetzt zählt das Muster hinter allen Responses.
Ressourcenkarte vervollständigen

Profile

/api/v1/profiles

Detail: /api/v1/profiles/{…}

Hobbys

/api/v1/hobbies

Detail: /api/v1/hobbies/{…}

Ist eine E-Mail-Adresse hier die API-ID eines Profils?
Erhält ein Consumer direkten Zugriff auf die Profile-Datenbank?
Was bedeutet ProfileHobby in diesem Service?
Welche Ressourcen veröffentlicht der Provider?
Welche Daten waren nicht veröffentlicht? Mindestens zwei markieren.