<!-- Canonical URL: https://ask.atlascloud.ai/ar/trace-ai-video-request-submission-polling-download -->

# كيف تتبع طلب فيديو AI واحداً عبر الإرسال وpolling والتنزيل؟

> أنشئ operation ID ثابتاً قبل submission واربط به provider request وjob وpoll وwebhook وasset المخزن. لكل محاولة ID مستقل، ولا تُسجل الأسرار أو signed URLs.

<!-- Canonical URL: https://ask.atlascloud.ai/trace-ai-video-request-submission-polling-download -->

يمر طلب الفيديو غير المتزامن عبر أنظمة بلا ID مشترك. أنشئ مفتاح ارتباط دائم قبل أول remote call.

## أنشئ operation ID عند الحد

```json
{"operation_id":"vidop_01J...","tenant_id":"acct_42","request_fingerprint":"sha256:..."}
```

لا تضع بريد المستخدم أو prompt أو credential داخل ID.

## افصل operation وattempt وspan

| السجل | العدد | الغرض |
|---|---:|---|
| Operation | واحد | ارتباط أعمال ثابت |
| Submission attempt | واحد أو أكثر | تفسير retries |
| Provider mapping | صفر أو أكثر | وصل status وwebhook |
| Trace span | كثير | قياس المراحل |
| Asset | صفر أو أكثر | إثبات المخرج الدائم |

## مرر trace context عبر قائمة الانتظار

يحمل كل message `operation_id` و`attempt_id` وtrace context. لكل redelivery سجل منفصل.

## سجّل الدليل قبل submission وبعده

قبل call احفظ fingerprint وroute وidempotency key؛ وبعده HTTP وrequest ID وjob ID وusage. يصبح timeout حالة `submission_unknown`.

## تتبع polling من دون ضوضاء في السجل

| الحقل | السبب |
|---|---|
| Provider job ID | ارتباط خارجي |
| الحالة الخام والموحدة | تدقيق adapter |
| HTTP | تشخيص |
| Latency | قياس |
| Poll التالي | شرح scheduler |

## اربط webhooks بأمان

تحقق من التوقيع وأزل التكرار وابحث عن mapping. خزّن مؤقتاً الحدث الذي يصل مبكراً.

## تتبع التنزيل والتخزين الدائم

سجّل bytes وtype وchecksum والتحقق وobject key والمدة من دون signed URL الكامل.

## ابنِ خطاً زمنياً واحداً للدعم

```text
accepted -> provider accepted -> processing -> webhook succeeded -> asset stored
```

يوحد [Atlas Cloud](https://www.atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=trace-ai-video-request-submission-polling-download) الوصول، لكن كل attempt يحتفظ بالنموذج وroute الدقيقين.

## الخلاصة

اربط operation ID ثابتاً وattempt IDs وmappings دائمة وسجلات محجوبة حتى asset المتحقق منه.

## FAQ

### ما ID الجذر للـtrace؟

Operation ID ينشئه التطبيق قبل الاتصال الخارجي.

### هل تشترك retries في trace نفسه؟

تشترك في operation ID ولكل منها attempt ID وspan منفصلان.

### ماذا نسجل عند كل poll؟

الوقت وjob ID والحالة وHTTP وmetadata اللازمة وموعد الفحص التالي.

### كيف نربط webhook؟

نستخدم mapping دائم من provider job إلى operation.

### هل نسجل signed download URL؟

لا. نعامله كبيانات اعتماد مؤقتة ونحجب URL الكامل.

### أين يدخل Atlas Cloud؟

يوحد الوصول، بينما يحتفظ التطبيق بالمعرفات وroute وusage ونتيجة التخزين.
