مرجع API

تتيح لك واجهة Aman Gate إرسال كلمات مرور لمرة واحدة عبر SMS إلى الأرقام السورية. جميع الطلبات والردود بصيغة application/json. تحتاج إلى اشتراك فعّال، أو بيئة تجربة معتمدة، لإرسال الرموز.

يجب أن يتضمن كل طلب رمز API الخاص بك في ترويسة Authorization. تجده في قسم المطوّر في لوحة التحكم.

Authorization: Token <your_api_token>

إذا فعّلت قائمة عناوين IP المسموحة، تُرفض الطلبات من عناوين أخرى بالرمز 403.

يتطلب اشتراكاً فعّالاً وقالب رسالة معتمداً. الرسائل الفاشلة لا تُحتسب.

محتوى الطلب

curl -X POST https://aman-gate.com/api/otp/send/ \
  -H "Authorization: Token MY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
      "gsm": "963911000000",
      "template_id": 1,
      "code": "482910",
      "language": 1
  }'

الردود

{
  "id": 1427,
  "gsm": "963911000000",
  "template": 1,
  "template_name": "Login OTP",
  "template_code": "123456",
  "message": "Your verification code is: 123456",
  "status": "sent",
  "provider_response": "OK",
  "created_at": "2026-03-25T03:00:00Z",
  "sandbox": false
}

{
  "gsm": [
    "GSM must be a valid 12-digit Syrian mobile number starting with 9639."
  ]
}

{
  "detail": "You have used all 3 sandbox OTPs. Please subscribe to continue."
}

يمكن للحسابات الجديدة طلب بيئة تجربة مع 3 رسائل اختبار مجانية. تستخدم رسائل التجربة نقطة النهاية نفسها وتُميَّز بـ "sandbox": true في الرد.