API డాక్యుమెంటేషన్

GPTMail API

GPTMail API ఉపయోగించి HTTPS ద్వారా X-API-Key హెడర్‌తో తాత్కాలిక ఇన్‌బాక్స్‌లను సృష్టించండి, సందేశాల జాబితాను చూసి చదవండి, మెయిల్‌ను తొలగించండి. ఇది ఆటోమేటెడ్ పరీక్షలు, 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: మీ స్వంత domain జోడించండి

పబ్లిక్ డొమైన్ MX ధృవీకరణ పూర్తయిన తర్వాత: లాగిన్ చేయకుండా సమర్పిస్తే → API కీ (20000 అభ్యర్థనలు); లాగిన్ చేసి సమర్పిస్తే → 200 పాయింట్లు. ప్రతి డొమైన్‌కు ఒకే బహుమతి లభిస్తుంది. ముఖ్యమైనది: కనెక్ట్ అయిన తర్వాత ఆ డొమైన్ సఫిక్స్ ఈ సైట్‌లోని వినియోగదారులందరికీ అందుబాటులో ఉండే పబ్లిక్ సఫిక్స్ అవుతుంది, కాబట్టి ఇతర వినియోగదారులు కూడా దాని కింద మెయిల్‌బాక్స్ చిరునామాలు సృష్టించవచ్చు. సక్రియం అయిన తర్వాత ఈ డొమైన్‌ను మా సేవకు సూచించే MX రికార్డును తొలగించవద్దు, భర్తీ చేయవద్దు లేదా మార్చవద్దు. లేకపోతే తర్వాతి తనిఖీలు డొమైన్‌ను తప్పుగా కాన్ఫిగర్ చేసినదిగా పరిగణించవచ్చు. తర్వాతి తనిఖీలో MX రికార్డు చెల్లదని తేలితే, డొమైన్ నిష్క్రియం చేయబడుతుంది. MX రికార్డు వరుసగా 3 తనిఖీలలో చెల్లకుండా ఉంటే, సంబంధిత API కీ కూడా నిష్క్రియం చేయబడుతుంది. తర్వాత MX రికార్డు మళ్లీ చెల్లుబాటు అయితే, డొమైన్ స్వయంచాలకంగా మళ్లీ సక్రియం అవుతుంది.

డొమైన్‌లు

పరీక్ష కోసం పబ్లిక్ కీ

పరీక్ష కోసం క్రింద చూపిన భాగస్వామ్య పబ్లిక్ కీని X-API-Key హెడర్‌లో పంపండి. ఇది ప్రతిరోజూ మారుతుంది, మరియు దీనికి వినియోగదారులందరూ పంచుకునే 2,00,000 అభ్యర్థనల రోజువారీ పరిమితి ఉంటుంది.

ఈరోజు మిగిలినవి

రీసెట్ అవుతుంది

పబ్లిక్ కీ కోసం లైవ్ కోటా లోడ్ అవుతోంది...

క్రింద 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 ను తనిఖీ చేయండి.

  • మీకు సైట్‌లో ప్రస్తుతం మద్దతున్న domain తెలిస్తే, ముందుగా email జనరేషన్ ఎండ్‌పాయింట్ పిలవాల్సిన అవసరం లేదు. prefix@domain ను స్థానికంగా కూర్చి మెయిల్‌బాక్స్ API లను నేరుగా పిలవండి — ఒక 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=...

మెయిల్‌బాక్స్ ఇమెయిల్‌లను పొందండి.

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

ఒక్క ఇమెయిల్ పొందండి — టెక్స్ట్, HTML, ముడి హెడర్‌లు మరియు మెటాడేటా సహా.

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

ID తో ఒక ఇమెయిల్ DELETE చేయండి.

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

మెయిల్‌బాక్స్‌లోని అన్ని ఇమెయిల్‌లను DELETE చేయండి.

GET
/api/stats

సైట్-వైడ్ గణాంకాలను చదవండి.

ఉదాహరణ ఫ్లో

క్రింద రెండు సాధారణ పద్ధతులు ఉన్నాయి: సేవ మీ కోసం ఇన్‌బాక్స్‌ను సృష్టించనివ్వండి, లేదా స్థిర ప్రిఫిక్స్‌ను అభ్యర్థించండి. ప్రస్తుతం మద్దతు ఉన్న డొమైన్ మీకు ఇప్పటికే తెలిస్తే, మెయిల్‌బాక్స్‌ను స్థానికంగా కూర్చి నేరుగా ప్రశ్నించవచ్చు.

1) యాదృచ్ఛిక తాత్కాలిక ఇమెయిల్ చిరునామాను సృష్టించండి

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) ఇన్‌బాక్స్‌లో ఇమెయిల్‌లను జాబితా చేయండి

మద్దతు ఉన్న డొమైన్ మీకు ఇప్పటికే తెలిస్తే, దశ 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) ఒకే ఇమెయిల్ చదవండి — సాదా టెక్స్ట్, 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 తో ఒక ఇమెయిల్ DELETE

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) మొత్తం ఇన్‌బాక్స్ శుభ్రం — ఈ చిరునామాకు అన్ని ఇమెయిల్‌లు తొలగిస్తుంది

ప్రతి కాల్ ఒక బ్యాచ్‌ను తొలగిస్తుంది. ప్రతిస్పందనలో "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 కీతో ప్రమాణీకరిస్తే, 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