Callback — Vendor API v0.6.5

GET /callbacks/patron/auth

Callback endpoint for Patron SSO authentication.

Ingen autentisering CallbackPatronAuthentication

Callback endpoint for Patron SSO authentication.

If the login is successful, the query parameters 'code' and 'state' are required. Otherwise, the query parameter 'error' is required.

Eksempel på kall

cURL

curl -X GET "$PLAS_BASE_URL/callbacks/patron/auth?version=0.6.5" \
  -H 'Accept: application/json'

JavaScript

const response = await fetch(`${process.env.PLAS_BASE_URL}/callbacks/patron/auth?version=0.6.5`, {
  method: "GET",
  headers: {
    "Accept": "application/json",
  },
});

Python

import os
import requests

response = requests.get(
    f"{os.environ['PLAS_BASE_URL']}/callbacks/patron/auth",
    params={
        "version": "0.6.5",
    },
    headers={
        "Accept": "application/json",
    },
)
response.raise_for_status()

Verten og tokenet er miljøvariabler: PLAS_BASE_URL providerens adresse.

Parametere

code: query · string
The code obtained from the SSO patron login.
Eksempel: SplxlOBeZQQYbYS6WxSbIA
state: query · string
The state send to the SSO patron login.
Eksempel: af0ifjsldkj
app_redirect_url: query · string (uri)
The app redirect url send to the SSO patron login.
Eksempel: https://app.nordby.bibliotek.example/callback
error: query · string
A machine-readable error code indicating why the operation failed. Its presence signifies a failure and should be handled accordingly by the Vendor Backend.
Eksempel: sso_unauthorized_client
error_description: query · string
A human-readable text providing additional details about the error. This is intended for logging and debugging purposes.
Eksempel: The patron cancelled the login.

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

Svar

302 Redirect to the application that initialized the SSO patron login, with the code and state as query parameters.

Ikke noe innhold i svaret.