ابدأ هنا
أول طلب API لك
أرسل ملفات العملاء والمعاملات من خادمك. تعرّف على تنسيق البيانات وإرسالها بأمان والتأكد من السجلات التي أُضيفت إلى WardenTrace.
هذه واجهة لاستلام الملفات، وليست واجهة عامة للسجلات التشغيلية. تستقبل ملفات multipart وليس سجلات JSON.
احصل على بيانات الاتصال
اطلب من WardenTrace رابط البيئة ومفتاح الاستلام. تأكد من صلاحيات التطبيق والمراقبة التلقائية، واحفظ مفاتيح الإنتاج في مدير أسرار خادمك.
المصادقةأرسل العملاء ثم المعاملات
ابدأ بقالب العملاء. استخدم upsert لتحديثهم. طبّق العملاء قبل إرسال معاملات تشير إليهم، وخصّص لكل ملف مفتاح Idempotency-Key ثابتاً.
POST /api/ingestتحقق من التسليم
احفظ uploadId من الرد، ثم تحقق من حالة التسليم بهذا المعرّف. ظهوره في appliedUploadIds يؤكد تطبيق سجلاتك. رمز HTTP 200 وحده لا يؤكد التطبيق أو المراقبة.
GET /api/ingest/status
القبول لا يعني التطبيق دائماً
بدون صلاحية التطبيق التلقائي ينتظر الملف السليم في البيانات ← سجل الرفع. يطبّقه شخص مخوّل باستخدام الملف الأصلي. المراقبة خطوة منفصلة وغير متزامنة.
فهم دورة التسليم