Παρακολούθηση Προόδου Ανέβασμα με Συνδρομές

Αφού ανεβάσετε ένα αρχείο στο προ-υπογεγραμμένο URL του S3, η πλατφόρμα συνεχίζει την επεξεργασία του ασύγχρονα.

Χρησιμοποιήστε το subscribeUserFeed για να λαμβάνετε σε πραγματικό χρόνο γεγονότα ανέβασματος αντί για polling.

Απλούστερη εναλλακτική

Αν δεν χρειάζεστε γεγονότα σε πραγματικό χρόνο, μπορείτε να κάνετε polling στο πεδίο fileUploaded του προτύπου μέχρι να επιστρέψει true.

Για το γενικό σχήμα γεγονότων, δείτε το Subscription Event Format.

Feed και Κατηγορία

Τα γεγονότα ανέβασματος αποστέλλονται στο:

• subscribeUserFeed

Χρησιμοποιούν:

• category: "upload"

Ονόματα Γεγονότων

Η επεξεργασία ανέβασματος εκπέμπει μια ακολουθία γεγονότων όπως:

• uploadScanned
• uploadTypeChecked
• uploadConverting
• uploadFlattened
• uploadTagsParsed
• uploadPdfMetaExtracted
• uploadCompleted
• uploadFailed

Φορτίο Γεγονότος Ανέβασματος

Τα φορτία ανέβασματος χρησιμοποιούν αυτό το βασικό σχήμα:

{
  "version": "1.0",
  "eventId": "evt...",
  "timestamp": "2026-04-24T10:38:36.822Z",
  "level": "INFO",
  "event": "uploadCompleted",
  "category": "upload",
  "groupId": null,
  "userId": "usr...",
  "requestId": null,
  "batchId": null,
  "error": null,
  "data": {
    "id": "tmp...",
    "key": "upload/usr.../tmp....pdf",
    "code": "UPLOADOK"
  }
}

data.code διατηρεί τον χαμηλότερο κώδικα επεξεργασίας κατά τη διάρκεια της μετανάστευσης και συμβατότητας.

Εντολή Συνδρομής

subscription SubscribeUserFeed {
  subscribeUserFeed {
    userId
    data
  }
}

Παράδειγμα JavaScript

const parseEnvelope = (payload) => {
  const raw = payload?.data;
  if (!raw) return null;
  return typeof raw === 'string' ? JSON.parse(raw) : raw;
};

const handleUserFeed = ({ data }) => {
  const wrapper = data?.subscribeUserFeed;
  const event = parseEnvelope(wrapper);

  if (event?.category !== 'upload') return;

  switch (event.event) {
    case 'uploadCompleted':
      console.log('upload complete', event.data.id, event.data.key);
      break;
    case 'uploadFailed':
      console.error('upload failed', event.data.code, event.data.key);
      break;
    default:
      console.log('upload progress', event.event, event.data.code);
  }
};

Πότε να το Χρησιμοποιήσετε

Αυτό είναι πιο χρήσιμο όταν θέλετε να:

• εμφανίσετε ένα συρτάρι προόδου ή χρονοδιάγραμμα κατάστασης ανέβασματος
• ανιχνεύσετε ασύγχρονες αποτυχίες επικύρωσης μετά την επιτυχία του PUT στο S3
• αντιδράσετε αμέσως όταν ένα πρότυπο ή ανεβασμένο αρχείο είναι έτοιμο