# Vendor API v0.6.7

3 grupper · 4 operasjoner · 4 stier · 153 skjemaer
Kilde: https://plasapi.com/no/vendor/v0.6.7/

Den andre veien — det tjenesten selv stiller til rådighet, slik at bibliotekssystemet kan sende hendelser og sende låneren tilbake etter en innlogging.

Generert fra `vendor_v0_6_7.yaml` · OpenAPI 3.0.0

- **Implementeres av:** Tjenesten — leverandørens egen backend
- **Kalles av:** Bibliotekssystemet, når noe har skjedd eller en innlogging skal fullføres

De tre andre API-ene beskriver hva en tjeneste kan kalle hos
bibliotekssystemet. Vendor API-et beskriver hva systemet sender til tjenesten
— derfor implementerer tjenesten det i stedet for å kalle det.

Det har fire operasjoner. Bibliotekssystemet sender **hendelser** til
`POST /events/receiver`, så tjenesten ikke trenger å spørre igjen og igjen. Det
sender lånerens nettleser tilbake til tjenestens **callbacks** etter en
single sign-on-innlogging eller en registrering (`GET /callbacks/patron`) og
etter en sletting (`GET /callbacks/patron/delete`). Og `GET /version` finnes
som i de andre API-ene.

## Slik integrerer du

1. **Registrer mottakeren.** Tjenesten registrerer adressen sin og en
   hemmelighet med `RegisterEventReceiver` i Provider API-et. Hemmeligheten må
   være minst 16 tegn og bør være tilfeldig generert.
2. **Sjekk avsenderen.** Hendelsesmottakeren er sikret med den hemmeligheten
   (`EventReceiverSecretAuth` i spesifikasjonen). Mottakeren svarer `204`.
3. **Ta imot låneren.** Etter en innlogging sendes låneren tilbake med
   `code` og `state` — eller `error` hvis det ikke lyktes. Forløpet står i
   [Kom i gang](/no/kom-i-gang/#kall-den-andre-veien).

## Forholdet til de andre API-ene

Vendor API-et er en **inngang** på linje med Provider API-et, ikke en
delmengde av det: bare `GET /version` finnes begge steder. De to er retningene
i det samme samarbeidet — en tjeneste som både henter og mottar, kaller
Provider API-et og implementerer Vendor API-et.

## Felles for operasjonene

Disse definisjonene deles av API-ets operasjoner. De er dokumentert ett sted her; en operasjon viser bare det som er dens eget, pluss kodene den kan svare med.

### Autentisering

- `EventReceiverSecretAuth` · `apiKey`

### Parametere

- `version` (i `query`, [`Version`](https://plasapi.com/no/vendor/v0.6.7/schemas/#Version), valgfri, brukes av 3 av 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.

### Feilsvar

- `HttpCode400` ([`Errors`](https://plasapi.com/no/vendor/v0.6.7/schemas/#Errors), brukes av 1 av 4) — The list of errors.
- `HttpCode401Secret` (`Ikke noe innhold i svaret.`, brukes av 1 av 4) — Secret is invalid.

## Alle grupper

- [Version](https://plasapi.com/no/vendor/v0.6.7/version/) — 1 operasjon
- [Callback](https://plasapi.com/no/vendor/v0.6.7/callback/) — 2 operasjoner
- [Event](https://plasapi.com/no/vendor/v0.6.7/event/) — 1 operasjon
- [Skjemaindeks](https://plasapi.com/no/vendor/v0.6.7/schemas/) — 153 skjemaer