REST API: GET /overdues

Lees eerst de basisinformatie over de REST API.

Volledige lijst met alle items die te laat zijn

Het toegangspunt GET /overdues laat je toe om een volledige lijst op te vragen met items waarvan de voorziene uitleentermijn is verstreken.

URL parameters

• Geen input parameters

JSON resultaat

• code: HTTP response code (bv. 200 voor een correct resultaat)
• totaal: totaal aantal uitgeleende items die te laat zijn
• response: data van alle uitgeleende items die te laat zijn

API Voorbeeldcode in PHP

<?php
$curl = curl_init();
curl_setopt_array($curl, array(
    CURLOPT_URL => "https://api.colibris.be/ocerdues",
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_CONNECTTIMEOUT => 5,
    CURLOPT_TIMEOUT => 15,
    CURLOPT_HTTPHEADER => array(
	'X-Api-User: API_USER',
	'X-Api-Login: API_LOGIN',
	'X-Api-Key: API_KEY',
	'Content-Type: application/json'
    ),
));

$data = curl_exec($curl);
$http_code = curl_getinfo($curl, CURLINFO_HTTP_CODE);
$err = curl_error($curl);
curl_close($curl);

if ($err) {
    echo "Error #:" . $err;
} else {
    print_r($data);
}
?>

API Voorbeeldantwoord

{
    "code": "200",
    "totaal": 2,
    "response": [
        {
            "id": "000042",
            "naam": "Cleirbaut",
            "voornaam": "Jasmien",
            "sp1": "",
            "sp2": "",
            "externe_id": "",
            "type": "Boek",
            "colibris_barcode": "2100006501",
            "barcode": "9789029564502",
            "titel": "Animal Farm",
            "auteur": "Orwell, George",
            "jaar": 2007,
            "uitgever": "Arbeiderspers",
            "vestiging": "ANT",
            "lokaal": "BIB",
            "datum_uitleen": "2025-03-11 16:27:17",
            "datum_retour": "2025-04-08"
        },
        {
            "id": "000042",
            "naam": "Cleirbaut",
            "voornaam": "Jasmien",
            "sp1": "",
            "sp2": "",
            "externe_id": "",
            "type": "Boek",
            "colibris_barcode": "2100003401",
            "barcode": "9789461055064",
            "titel": "De kunst om gelukkig te zijn",
            "auteur": "Schopenhauer, Arthur",
            "jaar": 2011,
            "uitgever": "Boom uitgevers Amsterdam",
            "vestiging": "ANT",
            "lokaal": "BIB",
            "datum_uitleen": "2025-03-11 16:27:33",
            "datum_retour": "2025-02-08"
        }
    ]
}

Eigen aan deze verzameling is dat datum_retour in het verleden zal liggen.

Wanneer er geen items te laat zijn, dan blijft de array “response” leeg.

Meer informatie over de verschillende velden vind je in het artikel over het importeren van leners.