# Vendor API v0.6.7

3 grupper · 4 operationer · 4 stier · 153 skemaer
Kilde: https://plasapi.com/da/vendor/v0.6.7/

Den anden vej — det tjenesten selv stiller til rådighed, så bibliotekssystemet kan sende hændelser og sende låneren tilbage efter et login.

Genereret fra `vendor_v0_6_7.yaml` · OpenAPI 3.0.0

- **Implementeres af:** Tjenesten — leverandørens egen backend
- **Kaldes af:** Bibliotekssystemet, når noget er sket eller et login skal afsluttes

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](/da/kom-i-gang/#kald-den-anden-vej).

## 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.

## Fælles for operationerne

Disse definitioner deles af API’ets operationer. De er dokumenteret ét sted her; en operation viser kun det der er dens eget, plus de koder den kan svare med.

### Autentificering

- `EventReceiverSecretAuth` · `apiKey`

### Parametre

- `version` (i `query`, [`Version`](https://plasapi.com/da/vendor/v0.6.7/schemas/#Version), valgfri, bruges af 3 af 4) — The version of Open Library the vendor expects to receive, if this version isn't supported by the provider an error code 600 (Unsupported Open Library API version) is returned.

### Fejlsvar

- `HttpCode400` ([`Errors`](https://plasapi.com/da/vendor/v0.6.7/schemas/#Errors), bruges af 1 af 4) — The list of errors.
- `HttpCode401Secret` (`Intet indhold i svaret.`, bruges af 1 af 4) — Secret is invalid.

## Alle grupper

- [Version](https://plasapi.com/da/vendor/v0.6.7/version/) — 1 operation
- [Callback](https://plasapi.com/da/vendor/v0.6.7/callback/) — 2 operationer
- [Event](https://plasapi.com/da/vendor/v0.6.7/event/) — 1 operation
- [Skema-indeks](https://plasapi.com/da/vendor/v0.6.7/schemas/) — 153 skemaer