📘 وثائق المطورين

احصل على أوّل SMS خلال 90 ثانية

REST API، و4 SDK مكتوبة بأنواع، وWebhooks موقّعة، ومفاتيح Idempotency، ومجمّعات مخصّصة لمستأجر واحد على Enterprise. مرجع كامل + كود يعمل بلغتك.

بداية سريعة

ثلاث استدعاءات وانتهيت

  1. 1
    اشترِ رقماً

    اختر دولة + خدمة. نعيّن لك رقم هاتف حقيقياً من أرخص مجموعة سليمة من المجمّعات العلوية.

    curl -X POST https://api.eveses.com/api/v1/numbers/orders \
      -H "Authorization: Bearer $KEY" \
      -d '{"country":"ua","mode":"activation","service":"telegram"}'
    
    # → 201 Created · 142ms
    # { "order_id":"ord_91f3a2b8", "phone":"+380635551822", "status":"waiting", "price_cents":7 }
  2. 2
    انتظر SMS · استطلاع أو Webhook

    إمّا اشترك في Webhook activation.sms_received أو استطلع. p95 لوصول SMS هو 2.1 ثانية.

    curl https://api.eveses.com/api/v1/numbers/orders/ord_91f3a2b8/sms \
      -H "Authorization: Bearer $KEY"
    
    # → 200 OK · 87ms
    # { "status":"sms_received", "sms":[{ "otp":"123456", "received_at":"..." }] }
  3. 3
    أنهِ — تُخصم الأموال

    حتى تستدعي finish، تبقى الأموال محتجزة، غير مُنفَقة. ألغِ في أيّ وقت ضمن النافذة لاسترداد كامل.

    curl -X POST https://api.eveses.com/api/v1/numbers/orders/ord_91f3a2b8/finish \
      -H "Authorization: Bearer $KEY"
    
    # → 200 OK · 61ms
    # { "status":"finished", "charged_cents":7 }

تصفّح الوثائق

قابلة للبحث، مع أمثلة بأربع لغات، وحقل جرّبها مباشر في كل نقطة نهاية.

🚀
البدء السريع

أول تحقق عبر SMS لديك في أقل من 90 ثانية — التسجيل، إنشاء مفتاح API، الحصول على الرمز.

⚡
التفعيلات

عمليات تحقق SMS مفردة — دورة حياة رمز لمرة واحدة من الطلب إلى الفوترة.

🔑
Authentication

How to authenticate API requests with bearer tokens.

📞
الإيجارات

احتفظ برقم لساعات أو أيام — استقبل عدة رسائل SMS، استعرض السجل، ومدّد عند الطلب.

🪝
Webhooks

استقبل أحداث التفعيلات والإيجارات والمحفظة كاستدعاءات HTTPS مع توقيع HMAC.

💰
المحفظة والإيداعات

الرصيد، الإيداعات، الـ Holds، المرتجعات، والشحن التلقائي — كيف تتحرك الأموال في حساب Eveses.

🔑
المصادقة ومفاتيح API

رموز Bearer، تدوير المفاتيح، قوائم IP المسموح بها، والأخطاء التي تظهر عند فشل المصادقة.

📦
SDKs

مكتبات العميل الرسمية: PHP، JavaScript، Python، Go — التثبيت، التهيئة، ومواقع الاستدعاء المهمة.

🔁
Idempotency

كيف يحمي رأس `Idempotency-Key` من الفوترة المزدوجة عند إعادة المحاولة على شبكات غير مستقرة.

⚙
OpenAPI و Postman

مواصفات OpenAPI حية، عارض Scalar، مجموعة Postman — أنشئ عملاء، خوادم mock، وأي شيء آخر.

📦 SDKs مكتوبة بأنواع

4 لغات · جميعها مولّدة من نفس مواصفات OpenAPI · إعادة محاولة تلقائية · أخطاء مكتوبة بأنواع.

JS@eveses/sdkPYEvesesGOevesescom/go-sdkPHPeveses/sdk
RBeveses-rb (soon)
RSeveses-rs (soon)
JVeveses-java (soon)

هل أنت جاهز للإطلاق؟

أوّل تفعيل على حسابنا · لا حاجة إلى بطاقة · استرداد إذا لم تصل SMS.

⚡ سجّل — ابدأ البناء
ابقَ على اطلاع

مواقع جديدة، تجمّعات جديدة، نقاط وصول جديدة.

نضيف دولاً ونُدوّر التجمّعات ونطلق تغييرات في الواجهة البرمجية كل أسبوع تقريباً. اترك بريدك وسنرسل ما يهم فعلاً: تغطية جغرافية جديدة، وتغييرات سلّم الأسعار، وكل ما قد يكسر تكاملك.

✓ مواقع ومنتجات جديدة⚡ تغييرات كاسرة في الواجهة🫥 بدون رسائل مزعجة

ألغِ الاشتراك بنقرة واحدة. لن نشارك بريدك الإلكتروني أبداً.