Event — Vendor API v0.6.7

POST /events/receiver

Receives events from an LMS

Bearer-token ReceiverEvents

Eksempel på kall

cURL

curl -X POST "$PLAS_BASE_URL/events/receiver?version=0.6.7" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $PLAS_TOKEN" \
  -d '{
  "eventId": "84410",
  "type": "consent_changed",
  "data": {
    "consent": {
      "available": [
        {
          "type": "loan_history",
          "version": "2025-01"
        }
      ],
      "evaluated": [
        {
          "given": true,
          "type": "loan_history",
          "version": "2025-01"
        }
      ]
    },
    "patronId": "40218873"
  }
}'

JavaScript

const response = await fetch(`${process.env.PLAS_BASE_URL}/events/receiver?version=0.6.7`, {
  method: "POST",
  headers: {
    "Accept": "application/json",
    "Content-Type": "application/json",
    "Authorization": `Bearer ${process.env.PLAS_TOKEN}`,
  },
  body: JSON.stringify({
    "eventId": "84410",
    "type": "consent_changed",
    "data": {
      "consent": {
        "available": [
          {
            "type": "loan_history",
            "version": "2025-01"
          }
        ],
        "evaluated": [
          {
            "given": true,
            "type": "loan_history",
            "version": "2025-01"
          }
        ]
      },
      "patronId": "40218873"
    }
  }),
});

Python

import os
import requests

response = requests.post(
    f"{os.environ['PLAS_BASE_URL']}/events/receiver",
    params={
        "version": "0.6.7",
    },
    headers={
        "Accept": "application/json",
        "Content-Type": "application/json",
        "Authorization": f"Bearer {os.environ['PLAS_TOKEN']}",
    },
    json={
        "eventId": "84410",
        "type": "consent_changed",
        "data": {
            "consent": {
                "available": [
                    {
                        "type": "loan_history",
                        "version": "2025-01",
                    },
                ],
                "evaluated": [
                    {
                        "given": True,
                        "type": "loan_history",
                        "version": "2025-01",
                    },
                ],
            },
            "patronId": "40218873",
        },
    },
)
response.raise_for_status()

Verten og tokenet er miljøvariabler: PLAS_BASE_URL providerens adresse · PLAS_TOKEN et access token.

Parametere

Felles for operasjonene: version. Se den felles kontrakten på versjonssiden.

Request body

application/json · påkrevd · EventReceiverRequest

Velges av feltet type

Variant: consent_changed

EventConsentChanged

eventIdstringpåkrevd
A unique identifier for the event.
typeunknownpåkrevd
dataobjectpåkrevd
Vis 2 felterSkjul 2 felter
- consentPatronConsentpåkrevd
  Se PatronConsent i skjemaindeksen
- patronIdstringpåkrevd

Variant: patron_deleted

EventPatronDeleted

eventIdstringpåkrevd
A unique identifier for the event.
typeunknownpåkrevd
dataobjectpåkrevd
Vis 1 feltSkjul 1 felt
- patronIdstringpåkrevd

Variant: reservation_ready_for_pickup

EventReservationReadyForPickup

eventIdstringpåkrevd
A unique identifier for the event.
typeunknownpåkrevd
dataobjectpåkrevd
Vis 2 felterSkjul 2 felter
- patronIdstringpåkrevd
- reservationPatronReservationpåkrevd
  Se PatronReservation i skjemaindeksen

Variant: ready_reservation_expires_soon

EventReadyReservationExpiresSoon

eventIdstringpåkrevd
A unique identifier for the event.
typeunknownpåkrevd
dataobjectpåkrevd
Vis 2 felterSkjul 2 felter
- patronIdstringpåkrevd
- reservationPatronReservationpåkrevd
  Se PatronReservation i skjemaindeksen

Variant: reservation_expires_soon

EventReservationExpiresSoon

eventIdstringpåkrevd
A unique identifier for the event.
typeunknownpåkrevd
dataobjectpåkrevd
Vis 2 felterSkjul 2 felter
- patronIdstringpåkrevd
- reservationPatronReservationpåkrevd
  Se PatronReservation i skjemaindeksen

Variant: reservation_reminder

EventReservationReminder

eventIdstringpåkrevd
A unique identifier for the event.
typeunknownpåkrevd
dataobjectpåkrevd
Vis 2 felterSkjul 2 felter
- patronIdstringpåkrevd
- reservationPatronReservationpåkrevd
  Se PatronReservation i skjemaindeksen

Variant: loan_due_date_is_approaching

EventLoanDueDateIsApproaching

eventIdstringpåkrevd
A unique identifier for the event.
typeunknownpåkrevd
dataobjectpåkrevd
Vis 2 felterSkjul 2 felter
- loanPatronLoanpåkrevd
  Se PatronLoan i skjemaindeksen
- patronIdstringpåkrevd

Variant: fee_due_date_is_approaching

EventFeeDueDateIsApproaching

eventIdstringpåkrevd
A unique identifier for the event.
typeunknownpåkrevd
dataobjectpåkrevd
Vis 2 felterSkjul 2 felter
- feePatronFeepåkrevd
  Se PatronFee i skjemaindeksen
- patronIdstringpåkrevd

Variant: item_checkout

EventItemCheckout

eventIdstringpåkrevd
A unique identifier for the event.
typeunknownpåkrevd
dataCheckoutCompletedpåkrevd
Vis 4 felterSkjul 4 felter
- messageCheckOutOrInMessage
  Se CheckOutOrInMessage i skjemaindeksen
- requestIdstringpåkrevd
  This is a unique identifier for the checkout request. This will change for each request.
  It is meant for correlating logs.
- statusstringpåkrevd
  This tells that the checkout went well and was completed.
  Én av: completed
- checkoutCheckoutFieldpåkrevd
  Se CheckoutField i skjemaindeksen

Variant: item_checkin

EventItemCheckin

eventIdstringpåkrevd
A unique identifier for the event.
typeunknownpåkrevd
dataCheckinCompletedWithPatronIdpåkrevd
Vis 4 felterSkjul 4 felter
- messageCheckOutOrInMessage
  Se CheckOutOrInMessage i skjemaindeksen
- requestIdstringpåkrevd
  This is a unique identifier for the checkin request. This will change for each request.
  It is meant for correlating logs.
- statusstringpåkrevd
  This tells that the checkin went well and was completed.
  Én av: completed
- checkinCheckinFieldWithRequiredPatronIdpåkrevd
  Se CheckinFieldWithRequiredPatronId i skjemaindeksen

Svar

204 OK

Ikke noe innhold i svaret.

400 The list of errors. Errors

Felles svar, definert én gang for hele API-et. Se den felles kontrakten på versjonssiden.

Generert fra skjemaet

Eksempel

{
  "errors": [
    {
      "code": 500,
      "info": "500: System error"
    }
  ]
}

Skjema

Errors

errorsarray of Errorpåkrevdmin. antall 1
The first error should always be the most relevant.
Vis 2 felterSkjul 2 felter
- codeintegerpåkrevd
  A number representing the type of error.
  List of error codes:
  - \<error code\>: \<error description\>
  - 500: System error
  - 600: Unsupported Open Library API version</br>
  Én av: 500 · 600
- infostringpåkrevd
  Starts with the text matching the error code field (defined above), and a describing text could be added.

401 Secret is invalid.

Felles svar, definert én gang for hele API-et. Se den felles kontrakten på versjonssiden.

Ikke noe innhold i svaret.