⚡

सक्रियण

प्रति-SMS सत्यापन — अनुरोध से बिलिंग तक एक एकल वन-टाइम कोड का जीवनचक्र।

सक्रियण क्या है

सक्रियण एक SMS-OTP के लिए नंबर का अल्पकालिक किराया है। आप अनुरोध करते हैं, प्लेटफ़ॉर्म नंबर आरक्षित करता है, आप आने वाले SMS से कोड पढ़ते हैं, और सक्रियण बंद हो जाता है — या तो सफलतापूर्वक (बिल किया गया) या समाप्त (मुफ्त)।

जब आपको केवल एक कोड चाहिए (साइनअप, पासवर्ड रीसेट, KYC) तब सक्रियण का उपयोग करें। लंबी विंडो में कई SMS के लिए Rentals देखें।

जीवनचक्र

waiting ─► sms_received ─► finished       (आप पुष्टि करते हैं; बिल)
   │                  └──► refunded       (कोई कोड नहीं; मुफ्त)
   └─► expired                            (टाइमआउट; मुफ्त)

waiting — नंबर आरक्षित, अभी कोई SMS नहीं।
sms_received — कम से कम एक इनबाउंड SMS कैप्चर किया गया।
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
  }'

फ़ील्ड	आवश्यक	विवरण
`country`	हाँ	ISO-2 देश कोड
`service`	हाँ	सेवा कैटलॉग से slug या `any`
`duration_minutes`	नहीं	5 से 60। डिफ़ॉल्ट 20
`max_price_cents`	नहीं	इस सीमा तक के किसी भी प्रदाता को विफलता पूल में जोड़ता है

पोलिंग

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

1.5–2 सेकंड अंतराल पर पोलिंग ठीक है; sub-second पोलिंग पर रेट सीमा है। उत्पादन में webhook दृढ़ता से अनुशंसित।

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 से पहले रद्द करता है। यदि SMS पहले से आ चुका है तो 409 लौटाता है (इसके बजाय finish कॉल करें)।

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

← पिछलाक्विकस्टार्ट अगला →Authentication

नए जियो, नए पूल, नए एंडपॉइंट।

हम लगभग हर हफ्ते देश जोड़ते हैं, पूल रोटेट करते हैं और API बदलाव रिलीज़ करते हैं। अपना ईमेल दें — हम वही भेजेंगे जो मायने रखता है: नई जियो कवरेज, प्राइस-लैडर बदलाव और वह सब जो इंटीग्रेशन तोड़ सकता है।

✓ नए जियो और प्रोडक्ट⚡ API के ब्रेकिंग बदलाव🫥 स्पैम कभी नहीं