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