Legalesign GraphQL API
Per utilizzare l'API di Legalesign è necessario contattarci per ottenere l'approvazione all'uso dell'API per il tuo account.
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. Ti serviranno conoscenze di JSON e esperienza di base con richieste web.
Perché scegliere GraphQL?
REST è affidabile, familiare e rimarrà. 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 versione — nuovi campi non rompono le query esistenti |
| Autenticazione | Chiave API | SRP o sottoinsieme chiave API |
GraphQL ti dà accesso completo alle funzionalità di Legalesign:
- Richiedi solo i dati necessari
- Un unico endpoint per tutto
- Stessa potenza dell'app web
Sviluppatori TypeScript/JavaScript
Considera il TS/JS SDK per casi d'uso comuni, ma imparare GraphQL ti dà accesso completo alla piattaforma. Confronta SDK vs GraphQL.
Prova GraphQL Ora
Inizia con il GraphQL Explorer (richiede account attivo).
L'Explorer ti permette di:
- Testare query e mutazioni
- Navigare nello schema completo
- Fare il debug prima di programmare
Se sei loggato in Legalesign, l'autenticazione è automatica.
Per un esempio minimo funzionante, vai al Quickstart.
Trova query e mutazioni pronte ispezionando le richieste di rete nella console web di Legalesign.
Accesso Programmatico
GraphQL supporta due modalità di autenticazione:
| Modalità | Copertura | Header | Consigliato per |
|---|---|---|---|
| SRP | Tutto lo schema GraphQL | Authorization: Bearer <access-token> | Integrazioni complete |
| Chiave API | Solo sottoinsieme supportato | Authorization: Bearer <api-key> | Automazione lato server e flussi comuni di invio/lettura |
Per l'autenticazione SRP, contatta il supporto Legalesign per ottenere le credenziali e i dettagli della tua integrazione.
Per l'autenticazione con chiave API, crea una chiave abilitata GraphQL nel Developer Portal e consulta la riferimento GraphQL chiave API per query e mutazioni supportate.
Vedi la guida all'autenticazione per maggiori dettagli.
Usi uno strumento AI per la programmazione?
Se usi Cursor, Claude, Windsurf o un altro assistente AI, connettilo al server di documentazione Legalesign per un aiuto contestuale mentre programmi. Vedi Connetti il tuo strumento AI.
Passi Successivi
- Inizia con il Quickstart
- Aggiungi eventi in tempo reale con il Real-Time Websocket Quickstart
- Esplora lo schema nel GraphQL Explorer
- Scegli autenticazione SRP o chiave API per l'accesso programmatico
- Segui un tutorial: Node.js · C#
- Connetti il tuo strumento AI per assistenza contestuale alla programmazione
GraphQL ti offre la stessa potenza dell'app web Legalesign — se puoi farlo lì, puoi farlo con l'API.