Αλλαγές στο REST API
Αλλαγές στο REST API v1 (/api/v1/).
2026
2026-07-02
Πόρος TemplatePDF — Νέο endpoint: GET /api/v1/templatepdf/{id}/component-token/ — επιστρέφει ένα token συστατικού προβολέα για ενσωμάτωση του PDF viewer component.
2026-07-01
Πόρος Signer — Νέο endpoint: GET /api/v1/signer/{id}/component-token/ — επιστρέφει token συστατικού για ενσωμάτωση του signing component. Απαιτεί μη legacy API key και η ομάδα πρέπει να είναι ενεργοποιημένη για χρήση συστατικών.
2026-05-20
Πόρος Document — Οι σύνδεσμοι υπογραφής signer που επιστρέφονται στην απόκριση API διατηρούνται πλέον ως σύνδεσμοι legacy μορφής για συμβατότητα με παλαιότερες εκδόσεις κατά τη χρήση batch/lobby υπογραφής.
2026-04-28
Πιστοποίηση — Ακόμα ένα σχήμα API key είναι διαθέσιμο. Τα υπάρχοντα κλειδιά συνεχίζουν να λειτουργούν. Συνιστάται έντονα η αναβάθμιση — δείτε developer.legalesign.com για λεπτομέρειες.
2026-01-21
Πόρος TemplatePDF — DELETE /api/v1/templatepdf/{id}/delete/ — ενημερώθηκε η διαγραφή για ασφαλή διαγραφή. Επιστρέφει σφάλμα αν αποτύχει (π.χ. πολιτική διατήρησης απαιτεί δευτερεύουσα έγκριση).
2026-01-06–07
Πόρος Document — Προστέθηκε πεδίο boolean append_history στην αποστολή εγγράφου και στην απόκριση λεπτομερειών. Όταν είναι true, η σελίδα ιστορικού υπογραφής προστίθεται στο ολοκληρωμένο PDF (αντιστοιχεί στη συμπεριφορά του υπάρχοντος append_pdf).
Αποσύρθηκε: Τα πεδία sign_mouse, sign_type, sign_upload στον πόρο εγγράφου αποσύρονται και θα αφαιρεθούν σε μελλοντική έκδοση.
2025
2025-12-18–19
Πόρος Document — Προστέθηκε παράμετρος skip για υπογράφοντες κατά την αποστολή εγγράφου. Ορισμός skip: true σε θέση υπογράφοντα παραλείπει αυτόν τον αποδέκτη από την αποστολή. Οι μάρτυρες που ακολουθούν έναν παραλειφθέντα υπογράφοντα παραλείπονται επίσης αυτόματα.
2025-10-30
Πόρος Document — Η δημιουργία πολιτικής διατήρησης μεταφέρθηκε από την αποστολή API στη ροή υπογραφής.
2025-10-08
- Πόρος Document — Η απόκριση
GET /api/v1/document/{id}/περιλαμβάνει πλέον έναν πίνακαsigner_objectsπαράλληλα με τον υπάρχοντα πίνακαsigners. Κάθε αντικείμενο περιέχει:firstname,lastname,email,tel,status,order,resource_uri,role,uuid. - Πόρος Signer — Προστέθηκε πεδίο
roleστην απόκριση signer ("signer","approver"ή"witness").
2025-09-26
- Πόρος Document —
DELETE /api/v1/document/{id}/— προστέθηκε προαιρετική παράμετρος ερωτήματοςemail=1για αποστολή ειδοποιήσεων με email κατά τη διαγραφή. - Πόρος TemplatePDF — Προστέθηκε παράμετρος
hide_sender_fieldsστο endpoint επεξεργασίας PDF. - Πόρος Element/Field — Τα αναζητήματα
pdftextκαιsignertextδέχονται πλέον UUID εκτός από όνομα ετικέτας. - Πόρος Signer — Προστέθηκε πεδίο
uuidστο αντικείμενο απόκρισης του signer.
2025-09-04
Πόρος Document — Όταν δεν παρέχεται μήνυμα κατά την αποστολή, χρησιμοποιείται αυτόματα το προεπιλεγμένο πρότυπο μηνύματος της ομάδας.
2025-08-22
Πόρος Document — Κατά την αποστολή εγγράφου, το αρχικό PDF αντιγράφεται από το πρότυπο στο αρχείο εγγράφου.
2025-06-10
Πόρος TemplatePDF — Νέο endpoint: POST /api/v1/templatepdf/{id}/archive/ — αρχειοθετεί το πρότυπο PDF.
2024
2024-10-17
Πόρος Document — Αφαιρέθηκε η αποσυρμένη παράμετρος signer append_to. Αυτή η παράμετρος δεν είχε κανένα αποτέλεσμα και αφαιρέθηκε.
2024-08-21
- Πόρος User — Οι χρήστες που δημιουργούνται μέσω API λαμβάνουν πλέον μόνιμο κωδικό πρόσβασης (όχι προσωρινό που απαιτεί επαναφορά).
- Πόρος Document — Η διαχείριση των τιμών υπογράφοντα στοιχείου διαχειριστή γίνεται σωστά για τον υπογράφοντα με δείκτη 0.
2024-08-20
- Πόρος Document — Οι παράμετροι
convert_sender_to_signerκαιstrict_fieldsδέχονται πλέονtrue/"true"/1(προηγουμένως μόνο booleanTrue). - Πόρος Signer/Element — Το πεδίο
signerείναι πλέον nullable· τα στοιχεία μεelement_type: "admin"αποκτούν προεπιλογή signer0. - Ρόλοι — Οι ρόλοι API συγχρονίζονται πλέον με το Console μετά τη δημιουργία εγγράφου.
- Μηνύματα σφάλματος — Βελτιωμένο σφάλμα όταν ο χρήστης δεν έχει σύνδεση με οργανισμό.
2024-08-19
Πόρος Group (Tab) — POST /api/v1/group/ — το name είναι πλέον το μόνο απαιτούμενο πεδίο. Το xframe_allow είναι τώρα προαιρετική παράμετρος.
2024-07-16
Πόρος Document — Η παράμετρος cc δέχεται πλέον την τιμή "default" για χρήση της προεπιλεγμένης λίστας CC email της ομάδας.
2024-06-14
Πόρος Document — Προστέθηκαν τα πεδία pdf_password και pdf_password_type στην απόκριση λεπτομερειών εγγράφου.
2024-02-20
Πόρος TemplatePDF — GET /api/v1/templatepdf/{id}/ (λήψη PDF) — προστέθηκε η παράμετρος ερωτήματος returnAsJson για επιστροφή του PDF ως base64 κωδικοποιημένη JSON απόκριση αντί για αρχείο για λήψη.
2024-02-09
Πόρος TemplatePDF — Διορθώθηκε ορθογραφικό λάθος στην απόκριση returnAsJson: documet_uri → document_uri.
2024-01-26
Πόρος TemplatePDF — POST /api/v1/templatepdf/ — προστέθηκε προαιρετική παράμετρος ερωτήματος returnAsJson. Όταν ορίζεται, το σώμα απόκρισης περιλαμβάνει { resource: { uid, status_uri, document_uri } } αντί για κενό 201.
2024-01-21
Πόρος Document — Βελτίωση απόδοσης: αναβαθμίστηκε το GET /api/v1/document/ (ταχύτερο ερώτημα μέτρησης).
2023
2023-09-27
Πόρος Document — GET /api/v1/document/ — προστέθηκαν δύο νέες παραμέτρους φίλτρου ερωτήματος:
created_gt— φιλτράρει έγγραφα που δημιουργήθηκαν μετά από δεδομένη ημερομηνία-ώρα (ISO 8601)modified_gt— φιλτράρει έγγραφα που τροποποιήθηκαν μετά από δεδομένη ημερομηνία-ώρα (ISO 8601)
Τα URLs σελιδοποίησης next/previous πλέον περιλαμβάνουν σωστά όλες τις ενεργές παραμέτρους φίλτρου.
2023-08-08
Πόρος Document — GET /api/v1/document/ — προστέθηκε παράμετρος φίλτρου sentUserId.
2023-07-07
Πόρος User — Οι διαχειριστές μπορούν πλέον να δημιουργούν υποχρήστες μέσω API.
2023-05-31
Πόρος Document — Οι μάρτυρες δεν συμπεριλαμβάνονται πλέον στην προεπιλεγμένη λίστα παραληπτών υπενθύμισης.
2023-04-17
- Πόρος Signer — Προστέθηκε πεδίο
rejection_reasonστην απόκριση signer. - Ονοματολογία — Διορθώσεις συνέπειας στην ονομασία πεδίων στο API.
2023-03-02
Webhooks — Το μέγιστο μήκος πεδίου callback_url επεκτάθηκε από 200 σε 500 χαρακτήρες.
2023-01-17
Πόρος Document — Προστέθηκαν τα πεδία tag2 και tag3 (επιπλέον των υπαρχόντων tag/tag1) στην αποστολή και απόκριση εγγράφου.
2022
2022-11-14–15
Πόρος Document — Αυξήθηκε ο μέγιστος αριθμός πεδίων ανά έγγραφο.
2022-11-02–03
Webhooks — Προστέθηκαν νέοι τύποι γεγονότων webhook. Ενημερώθηκαν τα στοιχεία usercallback.
2022-09-09
Πόρος Document — Προστέθηκε παράμετρος message_template στην αίτηση για καθορισμό προτύπου μηνύματος κατά την αποστολή.
2022-05-12
Πόρος Element/Field — Προστέθηκε πεδίο no_pdf: επιλογή για σήμανση πεδίου ώστε να μην αποδίδεται στο τελικό PDF.
2022-04-20
- Πόρος Document — Το πεδίο
roleδεν είναι πλέον υποχρεωτικό στο dict υπογράφοντα όταν αποστέλλεται έγγραφο χρησιμοποιώντας TemplatePDF. - Αναφορά σφαλμάτων — Βελτιωμένα μηνύματα σφάλματος σε όλο το API.
2022-04-06
Πόρος Element/Field — Προστέθηκε τύπος επικύρωσης regex (τύπος επικύρωσης 93) για τιμές πεδίων.
2022-02-24
Πόρος Element/Field — Προστέθηκε πεδίο label_extra.
2022-02-22
Πόρος TemplatePDF — Προστέθηκε επιλογή force_download κατά την ανάκτηση προσχεδίου PDF.
2022-02-17
Πόρος Document — Προστέθηκε υποστήριξη reviewers κατά την αποστολή εγγράφου.
2022-02-15
Πόρος Document — Προστέθηκε υποστήριξη πεδίου honorifics σε POST εγγράφου.
2021
2021-11-30
Πόρος Document — Νέο endpoint: GET /api/v1/document/{id}/auditlog/ — επιστρέφει το αρχείο καταγραφής επιθεώρησης για ένα έγγραφο.
2021-10-31
Πόρος Document — Η απόκριση GET /api/v1/document/ περιλαμβάνει πλέον πεδίο tag.
2021-10-30
Πόρος Document — Η απόκριση GET /api/v1/document/ περιλαμβάνει πλέον πεδίο location.
2021-10-28
Πόρος Document — Προστέθηκε υποστήριξη επικύρωσης πεδίων κατά την αποστολή εγγράφων μέσω API.
2021-10-27
Πόρος Document — Νέο endpoint: GET /api/v1/document/{id}/fields/ — επιστρέφει δεδομένα πεδίων για ένα έγγραφο.
2021-10-25
Πόρος Document — Προστέθηκε υποστήριξη bundle. Προστέθηκε παράμετρος convert_sender_to_signer κατά την αποστολή εγγράφου.
2021-08-17
Πόρος TemplatePDF — Προστέθηκε πεδίο archive_upon_send στη λίστα πεδίων πόρου template PDF.