Legalesign GraphQL API
Η Legalesign προσφέρει δύο API για ενσωμάτωση ηλεκτρονικών υπογραφών:
- REST API - Γρήγορη εκκίνηση, παραδοσιακή μορφή
- GraphQL API - Πλήρης ισχύς, πιο ευέλικτο
Αυτός ο οδηγός εστιάζει στο GraphQL. Θα χρειαστείτε γνώσεις JSON και βασική εμπειρία σε αιτήματα web.
Γιατί να επιλέξετε το GraphQL;
Το REST είναι αξιόπιστο, γνώριμο και εδώ για να μείνει. Το GraphQL σας προσφέρει έναν διαφορετικό τρόπο σκέψης για την ανάκτηση και διαμόρφωση δεδομένων. Στην Legalesign, το GraphQL είναι το API πρώτης κατηγορίας — κάθε μέρος της πλατφόρμας είναι διαθέσιμο μέσω αυτού.
| REST | GraphQL | |
|---|---|---|
| Endpoints | Πολλαπλά (/users, /contracts, κτλ.) | Ενιαίο (/graphql) |
| Ανάκτηση δεδομένων | Σταθερό ανά endpoint | Ερωτήματα ορισμένα από τον πελάτη |
| Υπερ/υπο-ανάκτηση | Συχνή | Μειωμένη |
| Έκδοση | Εκδόσεις (/v1/, /v2/) | Χωρίς εκδόσεις — νέα πεδία δεν σπάνε υπάρχοντα ερωτήματα |
| Πιστοποίηση | API key | SRP ή υποσύνολο API key |
Το GraphQL σας δίνει πλήρη πρόσβαση στις λειτουργίες της Legalesign:
- Ζητήστε μόνο τα δεδομένα που χρειάζεστε
- Ενιαίο endpoint για τα πάντα
- Ίση ισχύ με την web εφαρμογή
Προγραμματιστές TypeScript/JavaScript
Σκεφτείτε το TS/JS SDK για κοινές χρήσεις, αλλά η εκμάθηση του GraphQL σας προσφέρει πλήρη πρόσβαση στην πλατφόρμα. Συγκρίνετε SDK και GraphQL.
Δοκιμάστε το GraphQL Τώρα
Ξεκινήστε με το GraphQL Explorer (απαιτεί ενεργό λογαριασμό).
Ο Explorer σας επιτρέπει να:
- Δοκιμάζετε ερωτήματα και μεταλλάξεις
- Περιηγηθείτε στο πλήρες σχήμα
- Εντοπίστε σφάλματα πριν τον προγραμματισμό
Αν είστε συνδεδεμένοι στη Legalesign, η πιστοποίηση γίνεται αυτόματα.
Για ένα ελάχιστο πρώτο λειτουργικό παράδειγμα, πηγαίνετε στο Quickstart.
Βρείτε έτοιμα ερωτήματα και μεταλλάξεις ελέγχοντας τα δίκτυα αιτήματα στην κονσόλα της web εφαρμογής Legalesign.
Προγραμματιστική Πρόσβαση
Το GraphQL υποστηρίζει δύο τρόπους πιστοποίησης:
| Τρόπος | Κάλυψη | Header | Καλύτερο για |
|---|---|---|---|
| SRP | Πλήρες σχήμα GraphQL | Authorization: Bearer <access-token> | Ολοκληρωμένες ενσωματώσεις |
| API Key | Υποστηριζόμενο υποσύνολο μόνο | Authorization: Bearer <api-key> | Αυτοματοποίηση διακομιστή και κοινές ροές αποστολής/ανάγνωσης |
Για πιστοποίηση SRP, επικοινωνήστε με την Υποστήριξη Legalesign για να λάβετε τα διαπιστευτήρια και λεπτομέρειες για την ενσωμάτωσή σας.
Για πιστοποίηση με API-key, δημιουργήστε ένα κλειδί με ενεργοποιημένο GraphQL στο Developer Portal και δείτε την αναφορά API-key GraphQL για υποστηριζόμενα ερωτήματα και μεταλλάξεις.
Δείτε τον οδηγό πιστοποίησης για περισσότερες λεπτομέρειες.
Χρησιμοποιείτε Εργαλείο Κωδικοποίησης AI;
Αν χρησιμοποιείτε Cursor, Claude, Windsurf ή άλλο βοηθό AI, συνδέστε το στον διακομιστή εγγράφων Legalesign για βοηθητική υποστήριξη κατά τη συγγραφή κώδικα. Δείτε Σύνδεση του Εργαλείου AI.
Επόμενα Βήματα
- Ξεκινήστε με το Quickstart
- Προσθέστε πραγματικού χρόνου γεγονότα με το Real-Time Websocket Quickstart
- Εξερευνήστε το σχήμα στο GraphQL Explorer
- Επιλέξτε πιστοποίηση SRP ή API-key για προγραμματιστική πρόσβαση
- Ακολουθήστε ένα σεμινάριο: Node.js · C#
- Συνδέστε το εργαλείο AI σας για υποστήριξη συγγραφής κώδικα με βάση το πλαίσιο
Το GraphQL σας δίνει την ίδια δύναμη με την web εφαρμογή Legalesign — αν μπορείτε να το κάνετε εκεί, μπορείτε να το κάνετε και με το API.