التفعيلات

ما هو التفعيل؟

التفعيل هو استئجار قصير لرقم من أجل رسالة OTP واحدة. أنت تطلبه، تحجز المنصة رقماً، تقرأ الرمز من الرسالة الواردة، ثم يُغلق التفعيل — إما بنجاح (مع فوترة) أو منتهي الصلاحية (مجاناً).

استخدم التفعيلات عندما تحتاج رمزاً واحداً فقط (تسجيل، إعادة تعيين كلمة مرور، KYC). للحصول على عدة رسائل خلال نافذة أطول، راجع Rentals.

دورة الحياة

waiting ─► sms_received ─► finished       (تأكيدك؛ فوترة)
   │                  └──► refunded       (لا رمز؛ مجاناً)
   └─► expired                            (انتهاء المهلة؛ مجاناً)

• waiting — تم حجز الرقم، لا SMS بعد.
• sms_received — تم التقاط رسالة واردة واحدة على الأقل.
• finished — استدعيت finish؛ تمت الفوترة.
• expired — انقضت المهلة بلا SMS؛ بدون فوترة.
• refunded — ألغيت قبل التأكيد؛ بدون فوترة.

الإنشاء

curl -X POST https://api.eveses.com/v1/activations \
  -H "Authorization: Bearer $EVESES_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "country": "ua",
    "service": "telegram",
    "duration_minutes": 15,
    "max_price_cents": 12
  }'

الاستعلام

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

استعلام كل 1.5–2 ثانية مقبول؛ الاستعلام بأقل من ثانية محدود. في الإنتاج يُوصى بشدة باستخدام Webhooks.

Finish

يؤكد التفعيل ويبدأ الفوترة. Idempotent — الاستدعاء مرتين آمن.

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

Cancel

يلغي قبل أي SMS. يرجع 409 إذا وصلت رسالة بالفعل (استدعِ finish بدلاً من ذلك).

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