مرجع API
الملاحظات
نقطة النهاية POST /api/v1/feedback
الملاحظات رسالة من مستخدم، مرتبطة اختياريًا بمعرّف حدث لتظهر على تلك المشكلة.
1الطلب
المفتاح العام في X-Blipit-Key أو ?key=. الجسم: message (من 1 إلى 5,000 حرف، مطلوب)، وname (حتى 128)، وemail (يُتحقق منه)، وevent_id (32 hex، الشرطات مسموحة)، وurl (يُحفظ بدون سلسلة الاستعلام).
curl https://in.blipit.io/api/v1/feedback \
-H "Content-Type: application/json" -H "X-Blipit-Key: <public key>" \
-d '{"message":"Checkout froze after I pressed pay","name":"Ana","email":"ana@example.com","event_id":"9f1c4b6d8e2a47f0b3c5d7e9a1b2c3d4"}'2الاستجابات
201 {id}. 400 مع الحقل الذي فشل. 401 مفتاح مجهول.
من المفيد معرفته
- 60 طلبًا في الدقيقة لكل مفتاح.
- إذا لم يكن الحدث قد عولج بعد، يُنشأ الرابط إلى مشكلته لاحقًا.
- تحمل استجابة 201 أيضًا ref، وهو الرقم المرجعي للبلاغ مثل BR-12، وemails، وتكون true عندما سيتلقى المُبلِّغ تحديثات بالبريد. يحدد locale الاختياري (en أو ar أو es أو fr أو de أو pt أو it أو nl أو tr أو zh أو ja) لغة هذه الرسائل؛ ومن دونه يستخدم Blipit القيمة context.device.language ثم لغة مساحة العمل.
- 409 عندما تأتي البيانات من منصة غير منصة المشروع، مثلًا {"error": "This project is for iOS. Create a separate Android project in Blipit and use its key.", "reason": "platform_mismatch", "project_platform": "ios", "sent_platform": "android"}. تجيب الأحداث والجلسات والسجلات وتتبعات ومقاييس OTLP وتقارير الأخطاء وتسجيلات الجلسات وweb vitals كلها بهذه الطريقة. البيانات المرفوضة لا تُحفظ ولا تُحسب من الحصة. تسجّل حزم Blipit SDK هذا الخطأ مرة واحدة وتتوقف عن الإرسال لبقية التشغيل. للإصلاح، أنشئ مشروعًا لتلك المنصة واستخدم مفتاحه.
هل واجهتك مشكلة؟ راسل support@blipit.io. المفاتيح ومعرّف كل مشروع موجودة تحت مفاتيح API في app.blipit.io.