واجهة الملاحظات
أرسل الحقيقة النهائية للقرار أو الحدث لتحسين دقة كشف الاحتيال وقياس النتائج.
| الطريقة | المسار | الاستخدام |
|---|---|---|
| POST | /api/v1/feedback/decision/:id | إسناد نتيجة نهائية لقرار |
| POST | /api/v1/feedback/event/:id | إسناد نتيجة نهائية لحدث |
| الحقل | النوع | مطلوب | الوصف |
|---|---|---|---|
| label | enum | نعم | FRAUD أو LEGIT أو CHARGEBACK أو REFUND أو FALSE_POSITIVE أو TRUE_POSITIVE |
| notes | string | لا | سياق التحقيق من دون أسرار أو بيانات غير لازمة |
| externalCaseId | string | لا | معرف الحالة في نظامك |
| Idempotency-Key | header | موصى به | يمنع تكرار الإرسال عند إعادة المحاولة |
POST /api/v1/feedback/event/:id
curl -X POST https://api.naiza.ai/api/v1/feedback/event/evt_123456 \ -H "x-api-key: naiza_api_sk_live_..." \ -H "Idempotency-Key: case_12345" \ -d '{ "label": "FRAUD", "externalCaseId": "case_12345" }'