Πήγαινε στο κύριο περιεχόμενο

Αντιμετώπιση Προβλημάτων Επικύρωσης Αποστολής

Η αλυσίδα αποστολής επικυρώνει την είσοδό της πριν ξεκινήσει η δημιουργία εγγράφου. Εάν η επικύρωση αποτύχει, η μετάλλαξη επιστρέφει το σφάλμα απευθείας στον πελάτη και δεν επιστρέφεται κωδικός εργασίας (task ID).

Αυτό ισχύει για:

Κείμενο για την Τεχνητή Νοημοσύνη σας​

Χρησιμοποιήστε αυτό όταν δίνετε οδηγίες σε εργαλείο Τεχνητής Νοημοσύνης για να βοηθήσει με τα workflows αποστολής Legalesign GraphQL:

Use the Legalesign GraphQL send validation rules below as the source of truth.

- Treat send input as strictly validated JSON.
- If send input is invalid, the mutation returns an error immediately and no task ID is returned.
- Only poll task after send succeeds and returns a task ID.
- For send workflows, monitor task.report.status until it reaches COMPLETED or FAILED.
- Prefer subscriptions over polling for production real-time UX.
- groupId, templateId, title, and recipients are required.
- Base64 IDs must decode to the expected prefixes:
  groupId=grp, templateId=tpl, roleId=rol, scheduleId=sch, experience=exp, field id=ele, attachment id=att.
- recipients must contain fewer than 200 items.
- Each recipient must include email and order.
- The input must include an initial recipient: either order 0, or order 1 when roleId is provided.
- The recipient with the lowest order number must have a non-empty email.
- title must be 1028 characters or fewer.
- tag must be 250 characters or fewer.
- pdfPassword must be 150 characters or fewer.
- documentCCEmail must contain 10 email addresses or fewer.
- redirect must be a valid URI or null.

Εάν η Τεχνητή Νοημοσύνη χρειάζεται πιο εκτενή καθοδήγηση, κατευθύνετέ την σε αυτή τη σελίδα.

Περίληψη για Τεχνητή Νοημοσύνη​

  • Θεωρήστε την είσοδο του send ως αυστηρό JSON με κανόνες επικύρωσης.
  • Εάν η είσοδος send είναι άκυρη, η μετάλλαξη επιστρέφει αμέσως σφάλμα και δεν επιστρέφεται κωδικός εργασίας.
  • Κάντε polling μόνο στο task αφού το send ολοκληρωθεί με επιτυχία και επιστρέψει κωδικό εργασίας.
  • Για τα workflows αποστολής, παρακολουθήστε το task.report.status μέχρι να φτάσει σε COMPLETED ή FAILED.
  • Για παραγωγική ροή εργασίας σε πραγματικό χρόνο, προτιμήστε τις συνδρομές (subscriptions) αντί για polling.

Πώς να Ανιχνεύσετε Αποτυχία Επικύρωσης​

Τρέξτε τη μετάλλαξη κανονικά.

  • Εάν η είσοδος είναι άκυρη, η μετάλλαξη επιστρέφει αμέσως σφάλμα επικύρωσης.
  • Εάν η είσοδος είναι έγκυρη, η μετάλλαξη επιστρέφει κωδικό εργασίας και η δημιουργία εγγράφου συνεχίζεται ασύγχρονα.

Αυτό σημαίνει ότι η αντιμετώπιση προβλημάτων επικύρωσης γίνεται κατά το χρόνο εκτέλεσης της μετάλλαξης, όχι μέσω του ερωτήματος task.

Ξεκινήστε polling του task μόνο αφού το send πετύχει και επιστρέψει κωδικό εργασίας.

Τι Είδους Σφάλματα Μπορείτε να Περιμένετε​

Ο επικυρωτής αποστολής ελέγχει το σχήμα και το περιεχόμενο του εισερχόμενου JSON πριν συνεχιστεί η επεξεργασία. Οι αποτυχίες επικύρωσης σχετίζονται ειδικά με το πεδίο που απέτυχε, για παράδειγμα:

  • send input missing required field 'groupId'
  • send input.groupId must be a base64-encoded group id
  • send input.recipients must include a recipient with order 0, or order 1 when roleId is provided
  • recipients[0].email must be a valid email
  • recipients[1].attachments[0] must be a base64-encoded attachment id

Συνηθισμένα Προβλήματα Επικύρωσης​

Ελλιπή απαιτούμενα πεδία κορυφαίου επιπέδου​

Τα πεδία αυτά είναι απαραίτητα:

  • groupId
  • templateId
  • title
  • recipients

Άκυρα κωδικοποιημένα IDs​

Ο επικυρωτής ελέγχει ότι τα IDs είναι κωδικοποιημένα σε base64 και έχουν το αναμενόμενο αποσυμβολοποιημένο πρόθεμα:

  • groupId -> grp
  • templateId -> tpl
  • roleId -> rol
  • scheduleId -> sch
  • experience -> exp
  • πεδίο id -> ele
  • κωδικός συνημμένου id -> att

Προβλήματα σειράς αποδεκτών​

Η είσοδος αποστολής πρέπει να περιλαμβάνει έναν αρχικό αποδέκτη:

  • είτε έναν αποδέκτη με order: 0
  • ή έναν αποδέκτη με order: 1 όταν παρέχεται roleId

Επίσης, ο αποδέκτης με τον μικρότερο αριθμό σειράς πρέπει να έχει μη κενό email.

Όρια πεδίων των αποδεκτών​

Οι κοινές κανόνες επικύρωσης αποδεκτών περιλαμβάνουν:

  • email πρέπει να είναι έγκυρο και να έχει το πολύ 75 χαρακτήρες
  • firstName και lastName πρέπει να έχουν το πολύ 60 χαρακτήρες
  • phoneNumber πρέπει να έχει το πολύ 120 χαρακτήρες
  • message πρέπει να έχει το πολύ 10000 χαρακτήρες
  • expiryDate πρέπει να είναι έγκυρο ISO 8601 datetime ή null
  • ccEmail πρέπει να είναι έγκυρο email
  • ccIncludeLink πρέπει να είναι boolean

Όρια πεδίων κορυφαίου επιπέδου​

Κοινοί κανόνες επικύρωσης επιπέδου αποστολής περιλαμβάνουν:

  • title πρέπει να έχει το πολύ 1028 χαρακτήρες
  • tag πρέπει να έχει το πολύ 250 χαρακτήρες
  • pdfPassword πρέπει να έχει το πολύ 150 χαρακτήρες
  • documentCCEmail πρέπει να περιέχει το πολύ 10 διευθύνσεις email
  • redirect πρέπει να είναι έγκυρος URI ή null
  • recipients πρέπει να περιέχει λιγότερα από 200 στοιχεία
  • senderFields και participantFields πρέπει να περιέχουν λιγότερα από 1000 στοιχεία το καθένα

Άκυρα φορτία προγραμμάτων ή πεδίων​

Εάν συμπεριλάβετε inline αποδεκτών προγράμματα ή τιμές πεδίων:

  • κάθε στοιχείο προγράμματος πρέπει να περιλαμβάνει daysAfter, frequency, when, timeOfDay, subject, message και skipWeekend
  • το when του προγράμματος πρέπει να είναι ένα από τα 1, 2 ή 3
  • τα subject και message του προγράμματος πρέπει να έχουν το πολύ 500 χαρακτήρες
  • κάθε είσοδος πεδίου πρέπει να περιλαμβάνει έγκυρο στοιχείο id

Συνιστώμενη Ροή Αποσφαλμάτωσης (Debugging)​

  1. Επιβεβαιώστε το φορτίο σας τοπικά με το Send Input JSON Schema.
  2. Τρέξτε τη μετάλλαξη.
  3. Εάν η μετάλλαξη επιστρέψει σφάλμα επικύρωσης, διορθώστε το φορτίο και δοκιμάστε ξανά.
  4. Εάν η μετάλλαξη επιστρέψει κωδικό εργασίας, ξεκινήστε polling του task για να παρακολουθείτε τη δημιουργία εγγράφου.

Πότε να Χρησιμοποιείτε Συνδρομές (Subscriptions) Αντί​

Το polling του task είναι κατάλληλο για να ξεκινήσετε, να δοκιμάσετε και να κάνετε πρωτότυπο.

Για παραγωγικές ροές εργασίας, χρησιμοποιήστε συνδρομές για ενημερώσεις σε πραγματικό χρόνο και θεωρήστε την κατάσταση του task μέσω polling ως εναλλακτικό εργαλείο ή για πρωτότυπο.

Για καθοδήγηση σχετικά με συνδρομές ειδικές για task, δείτε Track Send Tasks with Subscriptions.

Σχετικά​

Export This Article

Save a copy of this page as PDF or plain text.