የኤፒአይ ሰነድ

GPTMail ኤፒአይ

በ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: የራስዎን ዶሜይን ያክሉ

የህዝብ ዶሜይን MX ማረጋገጫን ካለፈ በኋላ፦ ሳይገቡ ከቀረበ → API ቁልፍ (20000 ጥያቄዎች)፤ ከገቡ በኋላ ከቀረበ → 200 ነጥቦች። እያንዳንዱ ዶሜይን አንድ ሽልማት ብቻ ያገኛል። አስፈላጊ፡ ከተገናኘ በኋላ የዚያ ዶሜይን suffix ለዚህ ጣቢያ ላይ ለሁሉም ተጠቃሚዎች የህዝብ suffix ይሆናል፣ ስለሆነም ሌሎች ተጠቃሚዎች በታች የፖስታ ሳጥን አድራሻዎች ሊፈጥሩ ይችላሉ። ከአግባብ ከተገናኘ በኋላ ወደ አገልግሎታችን የሚጠቁም የ MX መዝገብን አይሰርዙ፣ አይተካከሉ ወይም አይቀይሩ። አለበለዚያ በኋላ ያለ ምርመራ ዶሜይኑን እንደ ተሳሳተ ሊቆጥረው ይችላል። MX ምርመራ ከተገኘ ልክ ያልሆነ ከሆነ ዶሜይኑ ይሰናከላል። MX ለ 3 ተከታታይ ምርመራዎች ልክ ያልሆነ ከቆየ፣ የተያያዘው API Key ደግሞ ይሰናከላል። MX ትክክል ከሆነ በኋላ ዶሜይኑ በራስ-ሰር ይነቃል።

ጎራዎች

ይፋዊ የሙከራ ቁልፍ

ለሙከራ ከታች የሚታየውን የጋራ ይፋዊ ቁልፍ በX-API-Key ራስጌ ውስጥ ይላኩ። በየቀኑ ይቀየራል፤ ሁሉም ተጠቃሚዎች የሚጋሩት የ200,000 ጥያቄዎች ዕለታዊ ገደብ አለው።

ዛሬ የቀረ

ዳግም በ

ለህዝባዊ ቁልፍ የቀጥታ ኮታ በመጫን ላይ...

ከዚህ በታች ያለው የ API ማጣቀሻ እንደ Markdown ለ AI መሳሪያዎች፣ የእውቀት ጎታዎች ወይም README ሊቀዳ ይችላል።

መሰረታዊ URL: https://mail.chatgpt.org.uk

AI
llms.txt

·

llms-full.txt

(Markdown)

ፈጣን መጀመሪያ

  • X-API-Key: YOUR_KEY ቀላሉ አማራጭ ነው። ለፈጣን ሙከራዎች በYOUR_KEY ምትክ ከላይ የሚታየውን ዕለታዊ ይፋዊ ቁልፍ ይጠቀሙ።

  • አብዛኛዎቹ የሳጥን endpoints የ email መለኪያ ያስፈልጋሉ፣ ለምሳሌ ?email=demo@example.com።

  • የGPTMail API ምላሾች JSON ይጠቀማሉ፤ success፣ data እና error መስኮች አሏቸው። API ቁልፍ ሲጠቀሙ usage ይጨመራል። የCloudflare ስህተቶች፣ የጥያቄ ገደብ ምላሾችን ጨምሮ፣ HTML ሊመልሱ ይችላሉ። JSON ከመተንተንዎ በፊት የHTTP ሁኔታን እና Content-Type ያረጋግጡ።

  • በዚህ ጣቢያ ላይ አሁን የሚደገፍ domain ካወቁ መጀመሪያ የኢሜይል ማመንጨት endpoint መጥራት አያስፈልግም። በአካባቢዎ prefix@domain መገንባት እና የሳጥን API በቀጥታ መጥራት ይችላሉ፣ አንድ የ API ጥያቄ ይቆጥባል።

የጥያቄ ብዛት ገደቦች እና እንደገና መሞከር

  • GET እና POST /api/generate-email ለእያንዳንዱ ምንጭ IP በ10 ሰከንዶች ውስጥ 30 ጥያቄዎች የሚፈቅድ የጋራ ገደብ አላቸው። ይህ ለሕዝብ እና ለግል API ቁልፎች ይሠራል። በአንድ IP ላይ ያሉ የተለያዩ ቁልፎች እና ደንበኛ ፕሮግራሞች ይህን ገደብ ይጋራሉ።

  • ገደቡን ማለፍ HTTP 429 ይመልሳል፤ የኢሜይል አድራሻ መፍጠርም ለ10 ሰከንዶች ይታገዳል። እንደገና ከመሞከርዎ በፊት በRetry-After የተገለጸውን ጊዜ ይጠብቁ። ይህ ራስጌ ከሌለ፣ ቢያንስ 10 ሰከንዶች ይጠብቁ፤ ከዚያም የመጠበቂያ ጊዜውን እያሳደጉ እንደገና ይሞክሩ። አንድ IP የሚጋሩ ፕሮግራሞች በአንድ ጊዜ እንደገና እንዳይሞክሩ ያድርጉ።

  • ይህ ደንብ በገቢ መልእክት ሳጥን ውስጥ ያሉ መልእክቶችን በዝርዝር ለማየት ወይም አንድ ኢሜይል ለማንበብ አይሠራም። የAPI ቁልፍ ዕለታዊ እና አጠቃላይ ኮታዎች በተናጠል ይቀጥላሉ። 10 ሰከንዶች መጠበቅ ያለቀን የቁልፍ ኮታ አይመልስም።

ዋና ዋና የ API ነጥቦች

POST / GET
/api/generate-email

ጊዜያዊ የመልዕክት ሳጥን ይፍጠሩ። ለቀላሉ የዘፈቀደ ፍሰት GET ይጠቀሙ፣ ወይም ግልጽ ቁጥጥር ሲፈልጉ POST ከprefix እና domain ጋር።

GET
/api/emails?email=...

ለፖስታ ሳጥን ኢሜይሎች ያግኙ።

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

አንድ ኢሜይል ያግኙ፣ ጽሑፍ፣ HTML፣ ክፍተኛ ራስጌዎች እና ሜታዳታን ጨምሮ።

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

ኢሜይልን በ ID ሰርዝ።

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

በፖስታ ሳጥን ውስጥ ያሉ ሁሉንም ኢሜይሎች ሰርዝ።

GET
/api/stats

የሙሉውም ጣቢያ ስታትስቲክስ ያንብቡ።

የምሳሌ ፍሰት

ከዚህ በታች ሁለት የተለመዱ ዘዴዎች አሉ፡ አገልግሎቱ እንዲፈጥር ሳጥን ይፍቀዱ፣ ወይም ተወስኖ የተቀመጠ prefix ይጠይቁ። አሁን የሚደገፍ domain ካወቁ፣ በአካባቢዎ ሳጥን መፍጠር እና በቀጥታ መጠየቅ ይችላሉ።

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) በሳጥን ውስጥ ኢሜይሎች ዝርዝር

የሚደገፍ domain ካወቁ፣ ደረጃ 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 ሰርዝ

በ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 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