توثيق المطورين — 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.