توثيق المطورين — ARAM OTP Gateway

بوابة سحابية فائقة السرعة للمطورين والشركات تتيح إرسال والتحقق من رموز OTP عبر واتساب الرسمية وسيرفرات Evolution API في أقل من ثانيتين وبنسبة وصول 99.9%.

🔑 طرق المصادقة (Authentication)

استخدام API Key في ترويسة الطلب (Header)

أضف مفتاح الـ API Key الخاص بك في الترويسة X-API-Key في جميع الطلبات:

X-API-Key: aram_live_your_api_key_here

📲 إرسال كود OTP عبر واتساب (6 أرقام)

POST https://aram.website/v1/otp/send

تولد المنصة رمزاً عشوائياً مشفراً مكوناً من 6 أرقام (مثل 482915) وترسله مباشرة وفوراً إلى هاتف المستلم على واتساب. لا يظهر الرمز في الرد لأسباب أمنية.

curl -X POST https://aram.website/v1/otp/send \
  -H "Content-Type: application/json" \
  -H "X-API-Key: aram_live_your_api_key_here" \
  -d '{
    "to": "+9647700000000",
    "channel": "WHATSAPP",
    "locale": "ar"
  }'

نموذج الرد الناجح (200 OK):

{
  "success": true,
  "request_id": "otp_1771540600000_f3a1b89c",
  "status": "SENT",
  "channel": "whatsapp",
  "expires_in": 300,
  "expires_at": "2026-08-20T01:45:00.000Z"
}

✅ التحقق من صحة كود الـ OTP

POST https://aram.website/v1/otp/verify

عندما يقوم المستخدم بإدخال الـ 6 أرقام التي وصلته على الواتساب، أرسل request_id و code للتحقق:

curl -X POST https://aram.website/v1/otp/verify \
  -H "Content-Type: application/json" \
  -H "X-API-Key: aram_live_your_api_key_here" \
  -d '{
    "request_id": "otp_1771540600000_f3a1b89c",
    "code": "482915"
  }'

نموذج الرد عند صحة الرمز:

{
  "success": true,
  "request_id": "otp_1771540600000_f3a1b89c",
  "status": "VERIFIED",
  "verified_at": "2026-08-20T01:42:15.000Z"
}

🔍 استعلام حالة الـ OTP

GET https://aram.website/v1/otp/{request_id}
curl -X GET https://aram.website/v1/otp/otp_1771540600000_f3a1b89c \
  -H "X-API-Key: aram_live_your_api_key_here"

🪝 Webhooks وتوقيع الأمان (HMAC-SHA256)

تصلك إشعارات فورية بكل عملية إرسال أو تسليم أو قراءة أو تحقق عبر الـ Webhook مع توقيع أمني لمنع التلاعب في ترويسة X-Aram-Signature.

💬 الدعم الفني المباشر