Introduzione all'API

​

Indirizzo

https://api.dentalspace.ai/v1

​

Formato

​

Versioni

​

Risorse

​

Regole generali

• Una chiave, una clinica. La chiave vede solo la sua clinica, e solo alcune sedi se è limitata. Una risorsa di un’altra clinica risponde sempre 404 not_found, mai 403. Vedi Autenticazione.
• Scope per area. Ogni endpoint chiede uno scope, indicato nella sua pagina. I dati clinici hanno scope separati, spenti di default. Vedi Dati clinici.
• Elenchi a cursore. Gli elenchi restituiscono { "data", "nextCursor" }. Vedi Paginazione.
• Esiti negativi con 200. Alcune risposte dicono «non trovato» o «occupato» senza essere errori: GET /patients/lookup con un numero sconosciuto risponde 200 con found: false.
• Modifiche sicure. Le risorse modificabili restituiscono un ETag: rimandalo in If-Match e la modifica passa solo se nessuno ha cambiato la risorsa nel frattempo. Altrimenti 409 conflict con details.reason: "version_mismatch".
• Errori uniformi. { "error": { "code", "message", "details", "requestId" } }. Vedi Errori.
• Identificativo della richiesta. Ogni risposta porta X-Request-Id. Citalo all’assistenza.

​

Esempio: prenotare una visita

export DS_KEY="dsk_live_..."
export CAL="<id del calendario>"

# 1. Chi è questo numero?
curl -s "https://api.dentalspace.ai/v1/patients/lookup?phone=3391112233" \
  -H "Authorization: Bearer $DS_KEY"

# 2. Orari liberi della prossima settimana
curl -s "https://api.dentalspace.ai/v1/calendars/$CAL/availability?from=2026-10-12&to=2026-10-16" \
  -H "Authorization: Bearer $DS_KEY"

# 3. Prenota uno degli orari restituiti
curl -s -X POST "https://api.dentalspace.ai/v1/calendars/$CAL/bookings" \
  -H "Authorization: Bearer $DS_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: chiamata-8f2a-prenota" \
  -d '{"patientId":"<id del paziente>","start":"2026-10-13T09:30:00+02:00"}'