API कागजात

GPTMail API

X-API-Key हेडरसहित HTTPS मार्फत अस्थायी इनबक्स बनाउन, सन्देशहरूको सूची हेर्न र पढ्न तथा मेल मेटाउन GPTMail API प्रयोग गर्नुहोस्। यो स्वचालित परीक्षण, CI/CD पाइपलाइन र QA कार्यप्रवाहका लागि उपयुक्त छ।

API Key कसरी पाउने

Buy API requests

Purchase API requests with GPTMail points. Earn points through daily check-ins and public domains, or buy points with LDC at a 1:1 rate.

Buy with points / add requests

विकल्प 2: आफ्नो डोमेन थप्नुहोस्

सार्वजनिक डोमेनको MX प्रमाणीकरण सफल भएपछि: लगइन नगरी पेश गरेमा → API कुञ्जी (20000 अनुरोध); लगइन गरेर पेश गरेमा → 200 अङ्क। प्रत्येक डोमेनले एउटा मात्र पुरस्कार पाउँछ। महत्त्वपूर्ण: जोडिएपछि त्यो डोमेन प्रत्यय यो साइटका सबै प्रयोगकर्ताका लागि सार्वजनिक हुन्छ, अरूले पनि त्यस अन्तर्गत मेलबक्स ठेगाना बनाउन सक्छन्। सक्रियता पछि, हाम्रो सेवातर्फ इंगित गर्ने MX रेकर्ड नमेटाउनुहोस्, नप्रतिस्थापन गर्नुहोस् वा परिवर्तन नगर्नुहोस्। अन्यथा पछिका जाँचले डोमेन गलत कन्फिगर मान्न सक्छ। MX अवैध भए डोमेन निष्क्रिय हुन्छ। MX लगातार 3 जाँचसम्म अवैध रहे सम्बन्धित API Key पनि निष्क्रिय हुन्छ। पछि MX पुनः वैध भए डोमेन स्वचालित पुनः सक्रिय हुन्छ।

डोमेनहरू

सार्वजनिक परीक्षण कुञ्जी

परीक्षणका लागि, तल देखाइएको साझा सार्वजनिक कुञ्जी X-API-Key हेडरमा पठाउनुहोस्। यो हरेक दिन परिवर्तन हुन्छ र यसको दैनिक सीमा 200,000 अनुरोध हो, जुन सबै प्रयोगकर्ताबीच साझा हुन्छ।

आज बाँकी

रीसेट हुन्छ

सार्वजनिक key को लाइभ कोटा लोड हुँदैछ...

तलको API सन्दर्भ AI उपकरणहरू, ज्ञानकोष वा README का लागि Markdown को रूपमा प्रतिलिपि गर्न सकिन्छ।

आधार URL: https://mail.chatgpt.org.uk

AI
llms.txt

·

llms-full.txt

(Markdown)

छिटो सुरुवात

  • X-API-Key: YOUR_KEY सबैभन्दा सरल विकल्प हो। छिटो परीक्षणका लागि YOUR_KEY को ठाउँमा माथि देखाइएको दैनिक सार्वजनिक कुञ्जी प्रयोग गर्नुहोस्।

  • धेरै मेलबक्स एन्डपोइन्टलाई email प्यारामिटर चाहिन्छ, उदाहरण ?email=demo@example.com।

  • GPTMail API का जवाफहरूले success, data र error फिल्डसहित JSON प्रयोग गर्छन्, र API कुञ्जी प्रयोग गर्दा usage पनि समावेश हुन्छ। अनुरोध-दर सीमाका जवाफहरूसहित Cloudflare त्रुटिहरूले यसको सट्टा HTML फर्काउन सक्छन्। JSON पार्स गर्नुअघि HTTP स्थिति र Content-Type जाँच गर्नुहोस्।

  • यदि तपाईंलाई यो साइटमा हाल समर्थित डोमेन थाहा छ भने पहिले email उत्पन्न एन्डपोइन्ट कल गर्नु पर्दैन। तपाईं स्थानीय रूपमा prefix@domain बनाएर सिधै मेलबक्स APIs कल गर्न सक्नुहुन्छ, जसले एउटा API अनुरोध बचत गर्छ।

अनुरोध-दर सीमा र पुनः प्रयास

  • GET र POST /api/generate-email ले प्रति स्रोत IP हरेक 10 सेकेन्डमा 30 अनुरोधको साझा सीमा प्रयोग गर्छन्। यो सार्वजनिक र व्यक्तिगत दुवै API कुञ्जीमा लागू हुन्छ। एउटै IP पछाडिका फरक कुञ्जी र क्लाइन्टहरूले यो सीमा साझा गर्छन्।

  • यो सीमा नाघेमा HTTP 429 फर्किन्छ र 10 सेकेन्डसम्म इमेल सिर्जना रोकिन्छ। पुनः प्रयास गर्नुअघि Retry-After अवधिसम्म पर्खनुहोस्। यदि यो हेडर छैन भने, कम्तिमा 10 सेकेन्ड पर्खनुहोस्, त्यसपछि बढ्दो अन्तरालमा पुनः प्रयास गर्नुहोस्। एउटै IP साझा गर्ने क्लाइन्टहरूबाट एकैसाथ पुनः प्रयास गर्नबाट बच्नुहोस्।

  • यो नियम इनबक्स सूचीकरण वा एक-एक इमेल पढ्नमा लागू हुँदैन। API कुञ्जीका दैनिक र कुल कोटाहरू अझै छुट्टै लागू हुन्छन्। 10 सेकेन्ड पर्खँदा सकिएको कुञ्जी कोटा फेरि भरिँदैन।

मुख्य एन्डपोइन्टहरू

POST / GET
/api/generate-email

अस्थायी इनबक्स उत्पन्न गर्नुहोस्। सबैभन्दा सरल यादृच्छिक इनबक्स फ्लोका लागि GET प्रयोग गर्नुहोस्, वा स्पष्ट नियन्त्रण चाहँदा prefix र domain सहित POST।

GET
/api/emails?email=...

मेलबक्सका लागि email हरू ल्याउनुहोस्।

GET
/api/email/{id}?email=...

एउटा email ल्याउनुहोस् — पाठ, HTML, कच्चा हेडर र मेटाडेटा सहित।

DELETE
/api/email/{id}?email=...

ID द्वारा एउटा email मेटाउनुहोस्।

DELETE
/api/emails/clear?email=...

मेलबक्सका सबै email मेटाउनुहोस्।

GET
/api/stats

साइटव्यापी तथ्याङ्क पढ्नुहोस्।

उदाहरण प्रवाह

तल दुई सामान्य ढाँचाहरू छन्: सेवाले तपाईंका लागि इनबक्स बनाउन दिनुहोस्, वा निश्चित prefix माग्नुहोस्। यदि तपाईंलाई पहिले नै समर्थित डोमेन थाहा छ भने मेलबक्स स्थानीय रूपमा जोडेर सिधै सोध्नुहोस्।

1) यादृच्छिक अस्थायी email ठेगाना उत्पन्न गर्नुहोस्

curl 'https://mail.chatgpt.org.uk/api/generate-email' \
  -H 'X-API-Key: PUBLIC_API_KEY'
प्रतिक्रिया उदाहरण
{
  "success": true,
  "data": {
    "email": "a3f9c2b1@example.com"
  },
  "usage": {
    "daily_limit": 200000,
    "used_today": 1,
    "remaining_today": 199999,
    "total_limit": 200000,
    "total_usage": 1,
    "remaining_total": 199999
  }
}

2) निश्चित prefix सहित उत्पन्न गर्नुहोस् (उदा. demo@example.com)

curl -X POST 'https://mail.chatgpt.org.uk/api/generate-email' \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: PUBLIC_API_KEY' \
  -d '{"prefix":"demo"}'
प्रतिक्रिया उदाहरण
{
  "success": true,
  "data": {
    "email": "demo@example.com"
  },
  "usage": {
    "daily_limit": 200000,
    "used_today": 2,
    "remaining_today": 199998
  }
}

3) इनबक्समा email सूचीबद्ध गर्नुहोस्

यदि समर्थित डोमेन थाहा छ भने चरण 1 छोडेर सिधै सोध्नुहोस्।

curl 'https://mail.chatgpt.org.uk/api/emails?email=demo@example.com' \
  -H 'X-API-Key: PUBLIC_API_KEY'
प्रतिक्रिया उदाहरण
{
  "success": true,
  "data": {
    "emails": [
      {
        "id": "e5a7f3...",
        "email_address": "demo@example.com",
        "from_address": "noreply@github.com",
        "subject": "Your code: 654321",
        "content": "Your verification code is 654321",
        "html_content": "...",
        "has_html": true,
        "timestamp": 1709654321,
        "created_at": "2024-03-05T12:18:41Z"
      }
    ],
    "count": 1
  }
}

4) एउटा email पढ्नुहोस् — सादा पाठ, HTML बडी र मेटाडेटा सहित

EMAIL_ID लाई चरण 3 बाट फर्किएको id ले बदल्नुहोस्। इनबक्सको ठेगानालाई email का रूपमा पनि पठाउनुहोस् (मेटाउँदा र एट्याचमेन्ट डाउनलोड गर्दा पनि): यसो गर्दा इमेललाई ID द्वारा खोजिनुको सट्टा सिधै त्यसको इनबक्सबाट पढिन्छ। API कुञ्जी भएमा email प्यारामिटर ऐच्छिक हुन्छ, तर यसलाई पठाउँदा खोजी छिटो हुन्छ।

curl 'https://mail.chatgpt.org.uk/api/email/EMAIL_ID?email=demo@example.com' \
  -H 'X-API-Key: PUBLIC_API_KEY'
प्रतिक्रिया उदाहरण
{
  "success": true,
  "data": {
    "id": "e5a7f3...",
    "email_address": "demo@example.com",
    "from_address": "noreply@github.com",
    "subject": "Your code: 654321",
    "content": "Your verification code is 654321",
    "html_content": "<p>Your code is 654321</p>",
    "has_html": true,
    "timestamp": 1709654321,
    "raw_size": 2048,
    "created_at": "2024-03-05T12:18:41Z"
  }
}

5) ID द्वारा एउटा email मेटाउनुहोस्

API कुञ्जी भएमा email प्यारामिटर ऐच्छिक हुन्छ, तर यसलाई पठाउँदा खोजी छिटो हुन्छ।

curl -X DELETE 'https://mail.chatgpt.org.uk/api/email/EMAIL_ID?email=demo@example.com' \
  -H 'X-API-Key: PUBLIC_API_KEY'
प्रतिक्रिया उदाहरण
{
  "success": true,
  "data": {
    "message": "Email deleted"
  }
}

6) सम्पूर्ण इनबक्स खाली गर्नुहोस् — यो ठेगानाका सबै email मेटाउँछ

प्रत्येक कलले एउटा ब्याच मेटाउँछ। प्रतिक्रियामा "has_more": true भएसम्म, false फर्काउँदासम्म फेरि कल गर्नुहोस्।

curl -X DELETE 'https://mail.chatgpt.org.uk/api/emails/clear?email=demo@example.com' \
  -H 'X-API-Key: PUBLIC_API_KEY'
प्रतिक्रिया उदाहरण
{
  "success": true,
  "data": {
    "message": "Deleted 3 emails",
    "count": 3,
    "has_more": false
  }
}

प्रतिक्रियाको आकार

सफल प्रतिक्रियाहरू सामान्यतया यस्तो देखिन्छन्। API key ले प्रमाणीकरण गर्दा usage भित्रको कोटा जानकारीमा ध्यान दिनुहोस्।

{
  "success": true,
  "data": {
    "email": "demo@example.com"
  },
  "usage": {
    "daily_limit": 200000,
    "used_today": 1,
    "remaining_today": 199999,
    "total_limit": 200000,
    "total_usage": 1,
    "remaining_total": 199999
  }
}

विस्तारित तथ्याङ्क

  • /api/statistics/24h 24 घण्टाको एउटा अवधिको प्रति घण्टा वितरण फर्काउँछ; पुराना अवधिहरूका लागि offset=1,2,... प्रयोग गर्नुहोस्।
  • /api/statistics/top-subjects शीर्ष इमेल विषयहरू फर्काउँछ।
  • /api/statistics/top-domains सबैभन्दा सक्रिय डोमेनहरू फर्काउँछ।
  • /api/statistics/top-senders सबैभन्दा सक्रिय प्रेषकहरू फर्काउँछ।
GPTMail