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