ឯកសារ API

GPTMail API

ប្រើ API របស់ GPTMail ដើម្បីបង្កើតប្រអប់សំបុត្របណ្ដោះអាសន្ន រាយបញ្ជី និងអានសារ ព្រមទាំងលុបសំបុត្រតាម 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។ វាផ្លាស់ប្ដូររៀងរាល់ថ្ងៃ ហើយមានដែនកំណត់ប្រចាំថ្ងៃ 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។

  • ចំណុចបញ្ចប់ប្រអប់សំបុត្រភាគច្រើនតម្រូវឱ្យមានប៉ារ៉ាម៉ែត្រ email ឧទាហរណ៍ ?email=demo@example.com។

  • ការឆ្លើយតបរបស់ GPTMail API ប្រើ JSON ដែលមានវាល success, data និង error ព្រមទាំង usage នៅពេលប្រើកូនសោ API។ កំហុសរបស់ Cloudflare រួមទាំងការឆ្លើយតបពេលលើសដែនកំណត់ល្បឿន អាចត្រឡប់ HTML ជំនួសវិញ។ សូមពិនិត្យស្ថានភាព HTTP និង Content-Type មុនពេលញែក JSON។

  • បើអ្នកដឹងរួចហើយអំពី domain ដែលត្រូវបានគាំទ្រនៅទីនេះ អ្នកមិនចាំបាច់ហៅ endpoint បង្កើត email មុនទេ។ អ្នកអាចបង្កើត prefix@domain ក្នុងស្រុកហើយហៅ mailbox APIs ផ្ទាល់ សន្សំ request API មួយ។

ដែនកំណត់ល្បឿនសំណើ និងការព្យាយាមឡើងវិញ

  • GET និង POST /api/generate-email ប្រើដែនកំណត់រួមគ្នា 30 សំណើក្នុងរយៈពេល 10 វិនាទី សម្រាប់ IP ប្រភពនីមួយៗ។ វាអនុវត្តចំពោះកូនសោ API ទាំងសាធារណៈ និងផ្ទាល់ខ្លួន។ កូនសោ និងកម្មវិធីផ្សេងៗដែលនៅពីក្រោយ IP តែមួយប្រើដែនកំណត់នេះរួមគ្នា។

  • ការលើសដែនកំណត់នេះនឹងត្រឡប់ HTTP 429 ហើយរារាំងការបង្កើតអាសយដ្ឋានរយៈពេល 10 វិនាទី។ សូមរង់ចាំតាមរយៈពេលដែល Retry-After បញ្ជាក់ មុនពេលព្យាយាមម្ដងទៀត។ ប្រសិនបើគ្មានក្បាលនេះ សូមរង់ចាំយ៉ាងហោចណាស់ 10 វិនាទី បន្ទាប់មកព្យាយាមម្ដងទៀតដោយបង្កើនរយៈពេលរង់ចាំបន្តិចម្ដងៗ។ ចៀសវាងការព្យាយាមឡើងវិញក្នុងពេលតែមួយពីកម្មវិធីដែលប្រើ IP រួមគ្នា។

  • ច្បាប់នេះមិនអនុវត្តចំពោះការរាយបញ្ជីសារក្នុងប្រអប់សំបុត្រ ឬការអានអ៊ីមែលនីមួយៗទេ។ កូតាប្រចាំថ្ងៃ និងកូតាសរុបរបស់កូនសោ API នៅតែអនុវត្តដាច់ដោយឡែក។ ការរង់ចាំ 10 វិនាទីមិនស្ដារកូតាកូនសោដែលអស់ហើយវិញទេ។

Endpoints ស្នូល

POST / GET
/api/generate-email

បង្កើត inbox បណ្តោះអាសន្ន។ ប្រើ GET សម្រាប់លំហូរ inbox ចៃដន្យធម្មតា ឬ POST ជាមួយ prefix និង domain នៅពេលអ្នកចង់គ្រប់គ្រងច្បាស់លាស់។

GET
/api/emails?email=...

ទាញយក email សម្រាប់ mailbox មួយ។

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

ទាញយកអ៊ីមែលមួយ រួមទាំងអត្ថបទ HTML ក្បាលដើម និងទិន្នន័យមេតា។

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

លុប email មួយតាម ID។

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

លុប email ទាំងអស់ក្នុង mailbox មួយ។

GET
/api/stats

អានស្ថិតិទូទាំងគេហទំព័រ។

លំហូរឧទាហរណ៍

ខាងក្រោមជាទម្រង់ទូទៅពីរ៖ ឱ្យសេវាបង្កើត inbox សម្រាប់អ្នក ឬស្នើ prefix ថេរ។ បើអ្នកដឹងរួចហើយអំពី domain ដែលត្រូវបានគាំទ្របច្ចុប្បន្ន អ្នកក៏អាចបង្កើត mailbox ក្នុងស្រុកហើយសួររកដោយផ្ទាល់។

1) បង្កើតអាសយដ្ឋាន email បណ្តោះអាសន្នចៃដន្យ

curl 'https://mail.chatgpt.org.uk/api/generate-email' \
  -H 'X-API-Key: PUBLIC_API_KEY'
ឧទាហរណ៍ response
{
  "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"}'
ឧទាហរណ៍ response
{
  "success": true,
  "data": {
    "email": "demo@example.com"
  },
  "usage": {
    "daily_limit": 200000,
    "used_today": 2,
    "remaining_today": 199998
  }
}

3) រាយបញ្ជី email ក្នុង inbox

បើអ្នកដឹង domain ដែលត្រូវបានគាំទ្ររួច រំលងជំហាន 1 ហើយសួររកផ្ទាល់។

curl 'https://mail.chatgpt.org.uk/api/emails?email=demo@example.com' \
  -H 'X-API-Key: PUBLIC_API_KEY'
ឧទាហរណ៍ response
{
  "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 ដោយ id ដែលបានត្រឡប់មកពីជំហានទី 3។ សូមបញ្ជូនអាសយដ្ឋានប្រអប់សំបុត្រជា 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'
ឧទាហរណ៍ response
{
  "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) លុប email មួយតាម 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'
ឧទាហរណ៍ response
{
  "success": true,
  "data": {
    "message": "Email deleted"
  }
}

6) សម្អាត inbox ទាំងមូល — លុប 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'
ឧទាហរណ៍ response
{
  "success": true,
  "data": {
    "message": "Deleted 3 emails",
    "count": 3,
    "has_more": false
  }
}

រូបរាង Response

Response ជោគជ័យជាធម្មតាមានរូបរាងបែបនេះ។ បើអ្នកផ្ទៀងផ្ទាត់ជាមួយ API Key សូមចាប់យកព័ត៌មាន quota ក្នុង 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 ត្រឡប់ domain សកម្មបំផុត។
  • /api/statistics/top-senders ត្រឡប់អ្នកផ្ញើសកម្មបំផុត។
GPTMail