API esterne e sviluppatori
yourang.ai per sviluppatori
Cosa offre l'API esterna, a chi è rivolta, principi generali.
Per gestionali, portali, applicazioni custom o automazioni avanzate, yourang.ai espone un'API REST e un sistema di webhook che permettono di leggere e scrivere dati e di ricevere notifiche in tempo reale.
A chi è rivolta
- Sviluppatori interni. Team IT che vuole integrare yourang.ai con un PMS, un gestionale, un'app mobile.
- Partner integratori. Software house che costruiscono soluzioni per il settore ricettivo o servizi e vogliono offrire una connessione yourang.ai ai propri clienti.
- Power user con competenze tecniche. Chi usa strumenti no-code (Zapier, Make, n8n) può sfruttare API e webhook senza scrivere codice tradizionale.
Principi tecnici
- REST + JSON. Convenzioni standard: GET, POST, PUT, DELETE su URL parlanti. Tutti gli scambi sono in JSON UTF-8.
- Versionamento URL. L'API ha un prefisso versione (es. /api/external/v1/). Le modifiche incompatibili vanno in nuove versioni; le vecchie restano supportate con periodi di deprecazione comunicati.
- Schema separato. I payload dell'API esterna non condividono i campi interni del prodotto: hai una superficie stabile, indipendente dalle evoluzioni interne.
- HTTPS obbligatorio. Tutte le chiamate avvengono in TLS. Niente endpoint in chiaro.
Questa pagina ti è stata utile?