الواجهة البرمجية للبنوك والمحافظ

المصادقة

يصدر فريق موثوق مفتاحاً لكل جهة شريكة. أرسله في كل طلب:

Authorization: Bearer mwq_…

التحقق من مستفيد

GET https://mawthooq.jusoor-tech.com/api/v1/lookup?q=0501234567&organization=acme

{
  "data": {
    "verdict": "not_official",        // official | official_other_organization | not_official
    "safe": false,                    // | revoked | reported | confirmed_fraud | unknown | invalid
    "identifier": { "kind": "phone", "normalized": "+966501234567" },
    "claimed_organization": { "slug": "acme", "official_contacts": [ … ] },
    "risk": { "level": "high", "report_count": 4 },
    "attestation": { "alg": "Ed25519", "key_id": "…", "payload": { … }, "signature": "…" }
  }
}

دفعة حتى 100 عنصر: POST /api/v1/lookup/batch {"items":[{"q":"…","organization":"…","ref":"…"}]}

الإبلاغ عن مستفيد

POST https://mawthooq.jusoor-tech.com/api/v1/reports
{ "identifier": "+966501234567", "source": "phone_call", "description": "…",
  "organization": "acme", "amount_lost": 5000, "currency": "SAR", "case_ref": "CASE-991" }

التحقق من التوقيع

المفاتيح العامة منشورة في /.well-known/mawthooq-keys.json. التوقيع يغطي الـ payload بعد ترميزه JSON قانونياً (مفاتيح مرتبة، بلا مسافات، UTF-8 بلا تهريب).