MailSMMO
साइन इन

// REST API

REST API दस्तावेज़

टूल एंडपॉइंट GET इस्तेमाल करते हैं और { "status": "success", "data": … } जैसा JSON लौटाते हैं। साइन इन करने के बाद API Docs पेज से मिले ?api_key= पैरामीटर से प्रमाणीकरण करें।

एंडपॉइंट

बेस URL: https://mailsmmo.com

GET/api/v1/services

सेवाएँ — कीमत और स्टॉक

?service= के बिना पूरी सूची लौटाता है। ?service= के साथ एक सेवा की कीमत और स्टॉक लौटाता है। API key की ज़रूरत नहीं।

प्रमाणीकरण नहीं

  • service (वैकल्पिक) — पूरी सूची के लिए खाली छोड़ें; कोड देने पर एक सेवा लौटती है (facebook जैसे छोटे कोड भी स्वीकार)

सफल

{ "status": "success", "data": { "services": [
    { "code": "otp_gmail_facebook", "name": "Facebook", "price": 5000, "stock": 42 }
  ] } }

GET/api/v1/me

खाता जानकारी

कॉल करने वाले API key का ID, ईमेल और बैलेंस।

API key आवश्यक

सफल

{ "status": "success", "data": { "id": "b7e5...-uuid", "email": "demo@mailsmmo.com", "balance": 1000000, "created_at": "2026-01-15T08:30:00Z" } }

GET/api/v1/orders

ऑर्डर बनाएँ

दोनों के लिए एक ही एंडपॉइंट: Gmail OTP कोड (otp_gmail_*) एक OTP मेलबॉक्स देता है; स्टॉक उत्पाद कोड (hotmail_*…) मात्रा के हिसाब से खरीदता है। बैलेंस से सूचीबद्ध कीमत काटी जाती है।

API key आवश्यक

  • service — OTP सेवा कोड (otp_gmail_*) या स्टॉक उत्पाद कोड (जैसे hotmail_imap_12m_36m)
  • quantity (वैकल्पिक) — केवल एक-बार बिकने वाले ईमेल के लिए — मात्रा (डिफ़ॉल्ट 1)
  • unique_key (वैकल्पिक) — खुद बनाया गया UUID — दोबारा भेजने पर दो बार ऑर्डर या शुल्क नहीं होगा

सफल

{ "status": "success", "data": {
    "id": "b7e5a1c2-3d4e-4f60-8a91-2c3d4e5f6a7b", "email": "zurhansuzu@gmail.com",
    "service": "otp_gmail_facebook", "amount": 5000
  } }

GET/api/v1/orders/otp

ऑर्डर से OTP पाएँ

एक ऑर्डर का OTP पढ़ता है। API key की ज़रूरत नहीं — ऑर्डर कोड (order_id) ही एक्सेस key है।

प्रमाणीकरण नहीं

  • order_id — ऑर्डर कोड (ऑर्डर बनाते समय लौटाया जाता है)
  • unique_key (वैकल्पिक) — हर कॉल के लिए खुद बनाया गया नया UUID
  • from (वैकल्पिक) — Unix सेकंड — कोई नया कोड न हो तो otp/received_at नहीं लौटाए जाते

सफल

{ "status": "success", "data": {
    "otp": "481253", "amount": 5000, "received_at": 1732000000,
    "from": "security@facebookmail.com", "otp_history": [
      { "value": "481253", "received_at": 1732000000 }
    ] } }

GET/api/v1/otp/orders

OTP ऑर्डर सूची

किराए पर लिए गए Gmail OTP ऑर्डर, पेजों में, हर ऑर्डर के नवीनतम OTP के साथ।

API key आवश्यक

  • page (वैकल्पिक) — पेज (डिफ़ॉल्ट 1)
  • page_size (वैकल्पिक) — प्रति पेज पंक्तियाँ (डिफ़ॉल्ट 20, अधिकतम 200)

सफल

{ "status": "success", "data": { "orders": [
    { "id": "b7e5a1c2-3d4e-4f60-8a91-2c3d4e5f6a7b", "email": "...", "service": "otp_gmail_facebook",
      "latest_otp": "481253", "latest_link": null }
  ], "page": 1, "page_size": 20, "total": 137 } }

GET/api/v1/mail

सभी संदेश पढ़ें

एक मेलबॉक्स के सभी संदेश, निकाले गए OTP/लिंक के साथ।

API key आवश्यक

  • order_id — ऑर्डर कोड

सफल

{ "status": "success", "data": { "count": 1, "messages": [
    { "id": 88, "from": "...", "subject": "...", "otp": "481253", "received_at": "..." }
  ] } }

सामान्य त्रुटि कोड

{ "status": "error", "message": "out_of_stock", "retryable": true }
  • unauthorized — API key अमान्य है या मौजूद नहीं है (HTTP 401)
  • invalid_request — अनुरोध पैरामीटर अमान्य हैं (HTTP 400)
  • not_found — सेवा, ऑर्डर या एंडपॉइंट नहीं मिला (HTTP 404)
  • insufficient_balance — बैलेंस अपर्याप्त है (HTTP 402)
  • out_of_stock — स्टॉक खत्म (HTTP 409) — Gmail OTP: फिर से कोशिश योग्य, कुछ सेकंड में फिर कोशिश करें; एकमुश्त बिक्री वाला ईमेल: स्टॉक भरने की प्रतीक्षा करें
  • service_unavailable — सर्वर अभी ऑर्डर पूरा नहीं कर सका — उसी unique_key से फिर कोशिश करें (HTTP 503, फिर से कोशिश योग्य)
  • in_progress — ऑर्डर अंतिम रूप ले रहा है या प्रदाता के पास पहले से मौजूद हो सकता है — उसी unique_key से फिर कोशिश करें (HTTP 409, फिर से कोशिश योग्य)
  • forbidden — इस संसाधन की अनुमति नहीं है (HTTP 403)
  • idempotency_mismatch — unique_key किसी दूसरे अनुरोध के लिए इस्तेमाल हो चुका है — नया unique_key इस्तेमाल करें (HTTP 422)
  • order_cancelled — शुल्क लगने से पहले ऑर्डर छोड़ दिया गया, कुछ नहीं काटा गया — फिर कोशिश करें (HTTP 409, फिर से कोशिश योग्य)
  • too_many_requests — बहुत ज़्यादा अनुरोध — रुकें और फिर कोशिश करें (HTTP 429, फिर से कोशिश योग्य)
  • auth_unavailable — अभी API key जाँचा नहीं जा सका, key ठीक है — फिर कोशिश करें (HTTP 503, फिर से कोशिश योग्य)
  • shutting_down — सर्वर रीस्टार्ट हो रहा है — कुछ सेकंड में फिर कोशिश करें (HTTP 503, फिर से कोशिश योग्य)
  • payload_too_large — अनुरोध body बहुत बड़ा है (HTTP 413)
  • internal_server_error — सर्वर त्रुटि, कृपया बाद में कोशिश करें (HTTP 500)

AI और टूल के लिए दस्तावेज़

Markdown में पूरा दस्तावेज़ https://mailsmmo.com/llms.txt पर है — इंटीग्रेशन कोड बनाने के लिए इसे Cursor, Claude या ChatGPT में पेस्ट करें।

unique_key से सुरक्षित रीट्राई

हर ऑर्डर के साथ एक unique_key (खुद बनाया गया UUID) भेजें। अगर नेटवर्क टूट जाए, तो उसी unique_key से दोबारा कोशिश करें: आपको वही ऑर्डर वापस मिलेगा, न नया ऑर्डर बनेगा और न दोबारा पैसा कटेगा।

त्रुटि फ़ॉर्मेट

त्रुटि होने पर जवाब में सिर्फ़ status, message (snake_case त्रुटि कोड) और retryable होते हैं, जो बताता है कि दोबारा कोशिश करनी है या नहीं।

MailSMMO के साथ शुरुआत करें

मुफ़्त में साइन अप करें, वॉलेट टॉप-अप करें और कुछ ही मिनटों में अपना पहला मेल किराए पर लें।

खाता बनाएँ →