Legalesign GraphQL API
Legalesign offre due API per l'integrazione della firma elettronica:
- REST API - Avvio rapido, formato tradizionale
- GraphQL API - Massima potenza, più flessibile
Questa guida si concentra su GraphQL. Avrai bisogno di conoscenze di JSON e di esperienza base nelle richieste web.
Perché scegliere GraphQL?
REST è affidabile, familiare e destinato a rimanere. GraphQL ti offre un modo diverso di pensare al recupero e alla modellazione dei dati. In Legalesign, GraphQL è l'API di prima classe — ogni parte della piattaforma è disponibile tramite essa.
| REST | GraphQL | |
|---|---|---|
| Endpoint | Multipli (/users, /contracts, ecc.) | Singolo (/graphql) |
| Recupero dati | Fisso per endpoint | Query definite dal client |
| Over/under-fetching | Comune | Ridotto |
| Versioning | Versionato (/v1/, /v2/) | Senza versioni — i nuovi campi non interrompono le query esistenti |
| Autenticazione | API key | SRP o sottoinsieme API key |
GraphQL ti dà pieno accesso alle funzionalità di Legalesign:
- Richiedi solo i dati di cui hai bisogno
- Endpoint unico per tutto
- Stessa potenza dell’app web
Sviluppatori TypeScript/JavaScript
Considera il TS/JS SDK per i casi d’uso comuni, ma imparare GraphQL ti dà accesso completo alla piattaforma. Confronta SDK e GraphQL.
Prova GraphQL Ora
Inizia con il GraphQL Explorer (richiede un account attivo).
L’Explorer ti permette di:
- Testare query e mutation
- Esplorare lo schema completo
- Debuggare prima di programmare
Se sei loggato in Legalesign, l’autenticazione è automatica.
Per un esempio minimale e funzionante, vai al Quickstart.
Trova query e mutation già pronte ispezionando le richieste di rete nella console dell’app web Legalesign.
Accesso Programmatico
GraphQL supporta due modalità di autenticazione:
| Modalità | Copertura | Header | Ideale per |
|---|---|---|---|
| SRP | Schema GraphQL completo | Authorization: Bearer <access-token> | Integrazioni complete |
| API Key | Solo sottoinsieme supportato | Authorization: Bearer <api-key> | Automazione server-side e flussi comuni di invio/lettura |
Per l’autenticazione SRP, contatta il supporto Legalesign per ottenere credenziali e dettagli per l’integrazione.
Per l’autenticazione con API-key, crea una chiave abilitata per GraphQL nel Developer Portal e consulta il riferimento API-key GraphQL per query e mutation supportate.
Consulta la guida all’autenticazione per maggiori dettagli.
Usando uno strumento di coding AI?
Se usi Cursor, Claude, Windsurf o un altro assistente AI, collegalo al server documentazione Legalesign per assistenza contestuale mentre programmi. Vedi Collega il tuo strumento AI.
Prossimi Passi
- Inizia con il Quickstart
- Aggiungi eventi in tempo reale con il Real-Time Websocket Quickstart
- Esplora lo schema nel GraphQL Explorer
- Scegli l’autenticazione SRP o API-key per l’accesso programmatico
- Segui un tutorial: Node.js · C#
- Collega il tuo strumento AI per assistenza alla programmazione contestuale
GraphQL ti dà la stessa potenza dell’app web Legalesign — se puoi farlo lì, puoi farlo con l’API.