SDK Passepartout: client Node.js, PHP, Python

Reference tecnico. Ultima revisione: 20 agosto 2026. Versione API: v1.

Pubblichiamo SDK ufficiali per Node.js (18+), PHP (8.1+) e Python (3.10+). Ciascun SDK gestisce autenticazione, refresh token, retry con backoff, deserializzazione JSON tipizzata. Repository open source ospitati su GitLab con licenza MIT. Installazione: npm install @passepartoutextensions/client, composer require passepartoutextensions/client, pip install passepartoutextensions-client. La classe principale è PeClient con metodi prenotazioni.lista(), prenotazioni.crea(payload), tariffe.lista(daData, aData), disponibilita.snapshot(data). Ogni metodo restituisce una Promise o un oggetto tipizzato secondo il linguaggio. Le eccezioni tipizzate distinguono errori di autenticazione, di validazione, di rate limit e di server, permettendo gestione precisa lato integratore.

Esempio di richiesta

GET /v1/prenotazioni?data=2026-08-25&limit=50 HTTP/1.1
Host: api.passepartoutextensions.org
Authorization: Bearer <token>
Accept: application/json

Rate limit

600 richieste al minuto in fascia base, 3000 in fascia Enterprise. Header di risposta X-RateLimit-Remaining indica le richieste residue nel bucket corrente. In caso di superamento, risposta 429 con header Retry-After.