Dilynwch Gynnydd Llwytho i Fyny gyda Tanysgrifiadau

Ar ôl i chi lwytho ffeil i URL S3 wedi’i arwyddo ymlaen llaw, mae'r platfform yn parhau i’w brosesu'n asynchronig.

Defnyddiwch subscribeUserFeed i dderbyn digwyddiadau llwytho i fyny mewn amser real yn hytrach na phollio.

Amgen symlach

Os nad oes angen digwyddiadau amser real arnoch, gallwch drosi maes fileUploaded’r templed nes bydd yn dychwelyd true.

Ar gyfer y cynllun digwyddiad cyffredinol, gweler Fformat Digwyddiad Tanysgrifiad.

Bwyd a Categori

Darperir digwyddiadau llwytho i fyny ar:

• subscribeUserFeed

Maent yn defnyddio:

• category: "upload"

Enwau Digwyddiadau

Mae prosesu llwytho i fyny yn anfon dilyniant o ddigwyddiadau megis:

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

Payload Digwyddiad Llwytho i Fyny

Mae payloads llwytho i fyny yn defnyddio’r siâp sylfaenol hwn:

{
  "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 yn cadw’r cod prosesu lefel is ar hyd y mudo a chysondeb.

Gweithrediad Tanysgrifiad

subscription SubscribeUserFeed {
  subscribeUserFeed {
    userId
    data
  }
}

Enghraifft 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);
  }
};

Pryd i Ddefnyddio Hwn

Mae hyn o fwyaf o ddefnydd pan ydych eisiau:

• dangos drôr cynnydd neu amserlen statws llwytho i fyny
• canfod methiannau dilysu asynchronig ar ôl llwyddiant PUT S3
• ymateb ar unwaith pan fydd templed neu ased llwytho i fyny yn barod