# Vendor API v0.6.5

3 grupper · 3 operasjoner · 3 stier · 152 skjemaer
Kilde: https://plas.redia.dk/no/vendor/v0.6.5/

Den andre veien. Der Provider API er det bibliotekssystemet stiller til rådighet, er dette det biblioteksproduktet stiller til rådighet tilbake.

Generert fra `vendor_v0_6_5.yaml` · OpenAPI 3.0.0

- **Implementeres av:** Biblioteksproduktet — leverandørens egen tjeneste
- **Kalles av:** Bibliotekssystemet, når noe har skjedd eller skal fullføres

De tre andre API-ene beskriver hva du kan HENTE fra bibliotekssystemet. Dette
beskriver hva systemet kan SENDE til deg — og det er derfor du implementerer
det, ikke kaller det.

To ting bruker det. Bibliotekssystemet sender **events** når noe har skjedd, slik
at produktet ditt slipper å spørre om og om igjen; og det kaller et **callback**
når en låntaker har logget inn hos biblioteket og skal sendes tilbake til
produktet ditt som godkjent.

## Slik integrerer du

1. **Still endepunktet til rådighet.** `POST /events/receiver` skal ta imot og
   svare. Adressen er din egen; den avtales med provideren, akkurat som
   Provider API-ets base-URL avtales den andre veien.
2. **Verifiser avsenderen.** Kallet bærer en delt hemmelighet i headeren
   `X-OLA-SECRET` (`EventReceiverSecretAuth` i spesifikasjonen). Stemmer den
   ikke, svar `401` — det er det eneste som skiller bibliotekssystemet fra alle
   andre som kan nå adressen din.
3. **Ta imot versjonen.** `version` sendes som query-parameter på to av de tre
   operasjonene. Støtter du den ikke, svarer du med feilkode `600` — samme
   kontrakt som den andre veien, bare med deg som mottaker.

## Forholdet til de andre API-ene

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

## Felles for operasjonene

Disse definisjonene refereres av mange 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://plas.redia.dk/no/vendor/v0.6.5/schemas/#Version), valgfri, brukes av 2 av 3) — 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://plas.redia.dk/no/vendor/v0.6.5/schemas/#Errors), brukes av 1 av 3) — The list of errors.
- `HttpCode401Secret` (`Ikke noe innhold i svaret.`, brukes av 1 av 3) — Secret is invalid.

## Alle grupper

- [Callback](https://plas.redia.dk/no/vendor/v0.6.5/callback/) — 1 operasjon
- [Event](https://plas.redia.dk/no/vendor/v0.6.5/event/) — 1 operasjon
- [Version](https://plas.redia.dk/no/vendor/v0.6.5/version/) — 1 operasjon
- [Skjemaindeks](https://plas.redia.dk/no/vendor/v0.6.5/schemas/) — 152 skjemaer