تروستيني
إنشاء حساب

واجهة Trustini البرمجية للمطورين

ادمج درجة ثقة Trustini في متجرك أو نظامك أو منظومة التوصيل الخاصة بك. واجهة REST بسيطة، مصادقة بمفتاح، واستجابات JSON.

المصادقة

أنشئ مفتاح API من ملفك الشخصي في Trustini (قسم «واجهة Trustini البرمجية»، يتطلب حسابًا مميزًا) وأرسله في الترويسة Authorization: Bearer tk_live_… . كل عملية تحقق تُحتسب من حصتك بالساعة كما في التطبيق.

GET/api/v1/check?phone=55123456

حكم الثقة لرقم واحد: trusted، average، risky، high_risk، insufficient (بيانات غير كافية) أو unknown (غير معروف لدى المجتمع).

curl "https://trustini.app/api/v1/check?phone=55123456" \
  -H "Authorization: Bearer tk_live_VOTRE_CLE"

{ "phone_masked": "+216 5• ••• 456", "known": true,
  "verdict": "trusted", "total_orders": 9,
  "delivered": 8, "failed": 1 }

POST/api/v1/check-batch

حتى 200 رقم في طلب واحد — مثالي للتحقق من جولة اليوم. يجب أن تتسع الدفعة كاملة في حصتك المتبقية.

curl -X POST "https://trustini.app/api/v1/check-batch" \
  -H "Authorization: Bearer tk_live_VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{"phones": ["55123456", "98765432"]}'

POST/api/v1/orders

ادفع نتيجة طلب دفع عند الاستلام (delivered، returned، no_answer، refused، scam) — هذا هو المسار الذي تدمجه المنصات وشركات التوصيل الشريكة.

curl -X POST "https://trustini.app/api/v1/orders" \
  -H "Authorization: Bearer tk_live_VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{"phone": "55123456", "full_name": "Ahmed B.",
       "amount": 89.5, "delivery_company": "Aramex",
       "order_date": "2026-08-24", "status": "delivered"}'

GET/api/v1/me

معلومات الحساب: الخطة، الرصيد، الحصة المتبقية بالساعة.

curl "https://trustini.app/api/v1/me" \
  -H "Authorization: Bearer tk_live_VOTRE_CLE"

إضافة WooCommerce

اعرض حكم Trustini مباشرة في طلبات WooCommerce (شارة ملونة في القائمة وبطاقة الطلب)، ويمكنك اختياريًا دفع نتائج التسليم تلقائيًا إلى Trustini.

تنزيل الإضافة

التثبيت: الإضافات ← أضف جديد ← رفع الملف المضغوط ← تفعيل، ثم الصق مفتاح API في الإعدادات ← Trustini.