क्विकस्टार्ट

परिचय

Eveses SMS सत्यापन के लिए ऑन-डिमांड फ़ोन नंबर देता है। आप एक नंबर अनुरोध करते हैं, एक बार के कोड प्राप्त करते हैं, और भुगतान केवल तब करते हैं जब 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 आदि) चुनें और /v1/activations पर POST करें:

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 कोड पढ़ें

तृतीय-पक्ष सेवा के सत्यापन फ़ॉर्म में नंबर दर्ज करें, फिर SMS आने तक सक्रियण को पोल करें:

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

जब SMS आता है तो प्रतिक्रिया में OTP के साथ एक sms सरणी होगी। अधिकांश प्रदाता 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"}]}

अगले चरण

• पोलिंग बंद करें, वेबहुक का उपयोग करें — activation.sms_received की सदस्यता लें और हम OTP को आपको पुश करेंगे। Webhooks अनुभाग देखें।
• SDK का उपयोग करें — PHP, JavaScript, Python और Go के आधिकारिक पुस्तकालय SDKs में हैं।
• idempotency के बारे में पढ़ें — अपने create कॉल को Idempotency-Key में लपेटें ताकि रीट्राई दोहरा शुल्क न लें।