Integrazione Form
✦
Integra con un assistente AI
Scarica o copia il prompt di integrazione per Integrazione Form e incollalo in Claude Code, Cursor o Copilot: contiene auth, esempi end-to-end e checklist.
Il "form" è il flusso con cui si crea e si gestisce una pratica Dokicasa (es. un contratto di locazione). Hai due modi per integrarlo, scegli in base al tuo caso d'uso:
| Server-to-server | SDK JavaScript | |
|---|---|---|
| Dove gira | Il tuo backend | Il browser dell'utente finale |
| Auth | api_token (Bearer) | api_key + user_token |
| UI | La costruisci tu | Form pronto <dokicasa-form> |
| Quando | Hai già i dati e vuoi creare pratiche in automatico | Vuoi che l'utente compili il form nel tuo sito |
Entrambi convergono sugli stessi endpoint di lettura:
GET /api/v3/user/me/services— lista pratiche (filtrabile perexternal_id)GET /api/v3/practices/{practice}— dettaglio + statoGET /api/v3/practices/{practice}/tasks— task della pratica
INFO
Puoi anche mischiare i due approcci: creare la pratica server-to-server e poi mostrarne lo stato/task nella tua dashboard, oppure incorporare il form con l'SDK e leggere i risultati dal tuo backend.