البدء السريع

مقدمة

تقدم Eveses أرقام هواتف عند الطلب لعمليات التحقق عبر SMS. تطلب رقماً، تحصل على رمز لمرة واحدة، وتدفع فقط إذا وصلت الرسالة فعلياً.

ترشدك هذه الصفحة عبر أول طلب من البداية إلى النهاية في ثلاث خطوات صغيرة.

1. أنشئ مفتاح API

سجّل الدخول وافتح Account → API Keys. انقر على New key، أعطه اسماً (مثل local-dev)، وانسخ القيمة التي يعرضها مربع الحوار. يُكشف الرمز مرة واحدة فقط — احفظه فوراً في مدير كلمات المرور أو في ملف .env.

export EVESES_API_KEY="17|aBcDeFgHiJ…"

2. اطلب رقماً

اختر دولة (ISO-2) وخدمة slug (telegram، whatsapp، discord، any …) وأرسل POST إلى /v1/activations:

curl -X POST https://api.eveses.com/v1/activations \
  -H "Authorization: Bearer $EVESES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country": "ua", "service": "telegram", "duration_minutes": 5}'

تحمل الاستجابة الرقم المُستأجَر و id تفعيل تستخدمه لجلب الرمز:

{"id":"9a1f2c3d-4e5b-6a7c-8d9e-0f1a2b3c4d5e","phone":"+380635551822","status":"waiting","price_cents":50,"expires_at":"2026-05-26T14:35:00Z"}

3. اقرأ رمز SMS

أدخل الرقم في نموذج التحقق الخاص بالخدمة الخارجية، ثم استعلم عن التفعيل حتى تصل الرسالة:

curl https://api.eveses.com/v1/activations/9a1f2c3d-4e5b-6a7c-8d9e-0f1a2b3c4d5e \
  -H "Authorization: Bearer $EVESES_API_KEY"

عند وصول الرسالة، تحتوي الاستجابة على مصفوفة sms تحوي OTP. معظم المزودين يسلّمون خلال 30 ثانية. إذا لم يصل شيء قبل انتهاء التفعيل، فلن تُحاسب.

{"id":"9a1f2c3d-4e5b-6a7c-8d9e-0f1a2b3c4d5e","phone":"+380635551822","status":"sms_received","price_cents":50,"expires_at":"2026-05-26T14:35:00Z","sms":[{"code":"123456","text":"Your code: 123456","received_at":"2026-05-26T14:30:14Z"}]}

الخطوات التالية

• توقف عن الاستعلام، استخدم Webhooks — اشترك في activation.sms_received وسنرسل لك OTP. راجع قسم Webhooks.
• استخدم SDK — مكتبات PHP و JavaScript و Python و Go الرسمية موثّقة في SDKs.
• اقرأ عن idempotency — غلّف استدعاء الإنشاء بـ Idempotency-Key كي لا تُضاعف المحاولات المتكررة الفواتير.