Vendor API v0.6.7

De tre andre API’er beskriver hvad en tjeneste kan kalde hos bibliotekssystemet. Vendor API’et beskriver hvad systemet sender til tjenesten — derfor implementerer tjenesten det i stedet for at kalde det.

Det har fire operationer. Bibliotekssystemet sender hændelser til POST /events/receiver, så tjenesten ikke behøver at spørge igen og igen. Det sender lånerens browser tilbage til tjenestens callbacks efter et single sign-on-login eller en registrering (GET /callbacks/patron) og efter en sletning (GET /callbacks/patron/delete). Og GET /version findes som i de andre API’er.

Sådan integrerer du

1. Registrér modtageren. Tjenesten registrerer sin adresse og en hemmelighed med RegisterEventReceiver i Provider API’et. Hemmeligheden skal være mindst 16 tegn og bør være tilfældigt genereret.
2. Tjek afsenderen. Hændelsesmodtageren er sikret med den hemmelighed (EventReceiverSecretAuth i specifikationen). Modtageren svarer 204.
3. Tag imod låneren. Efter et login sendes låneren tilbage med code og state — eller error, hvis det ikke lykkedes. Forløbet står i Kom i gang.

Forholdet til de andre API’er

Vendor API’et er en indgang på linje med Provider API’et, ikke en delmængde af det: kun GET /version findes begge steder. De to er retningerne i samme samarbejde — en tjeneste der både henter og modtager, kalder Provider API’et og implementerer Vendor API’et.