API баримтжуулалт

GPTMail API

GPTMail API-г ашиглан X-API-Key толгойтой HTTPS хүсэлтээр түр шуудангийн хайрцаг үүсгэж, захидлуудыг жагсааж уншиж, устгах боломжтой. Энэ нь автомат тест, 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 хүсэлтийн хязгаартай.

Өнөөдөр үлдсэн

Дахин тохируулна

Нийтийн түлхүүрийн шууд квотыг ачааллаж байна...

Доорх API лавлагааг Markdown хэлбэрээр AI хэрэгслүүд, мэдлэгийн сан эсвэл README-д хуулах боломжтой.

Суурь хаяг: https://mail.chatgpt.org.uk

AI
llms.txt

·

llms-full.txt

(Markdown)

Түргэн эхлэл

  • X-API-Key: YOUR_KEY бол хамгийн энгийн сонголт. Түргэн туршилтад YOUR_KEY-ийн оронд дээр харуулсан өдрийн нийтийн түлхүүрийг ашиглаарай.

  • Ихэнх шуудангийн хайрцгийн endpoint-ууд email параметр шаарддаг, жишээ нь ?email=demo@example.com.

  • GPTMail API-ийн хариу нь success, data, error талбартай JSON бөгөөд API түлхүүр ашигласан үед usage талбар нэмэгдэнэ. Cloudflare-ийн алдаа, түүний дотор давтамжийн хязгаарын хариу нь оронд нь HTML буцааж болно. JSON задлахаасаа өмнө HTTP төлөв болон Content-Type-ийг шалгана уу.

  • Энэ сайт дээр дэмжигдэж буй домэйнийг мэдэж байвал эхлээд захиа үүсгэх endpoint дуудах шаардлагагүй. prefix@domain-ийг локальноо бүрдүүлж шуудангийн API-уудыг шууд дуудаж нэг API request хэмнэнэ.

Хүсэлтийн давтамжийн хязгаар ба дахин оролдлого

  • GET болон POST /api/generate-email нь эх IP хаяг тус бүрт 10 секундэд 30 хүсэлт гэсэн нийтлэг хязгаартай. Энэ нь нийтийн болон хувийн API түлхүүрт хоёуланд нь хамаарна. Нэг IP хаягийн ард байгаа өөр түлхүүр, клиентүүд энэ хязгаарыг хуваалцана.

  • Энэ хязгаарыг хэтрүүлбэл HTTP 429 буцааж, имэйл үүсгэхийг 10 секундээр хаана. Дахин оролдохоосоо өмнө Retry-After-д заасан хугацааг хүлээнэ үү. Хэрэв энэ толгой байхгүй бол дор хаяж 10 секунд хүлээгээд, дараа нь завсрын хугацааг нэмэгдүүлэн дахин оролдоно уу. Нэг IP хуваалцдаг клиентүүд зэрэг дахин оролдохоос зайлсхийнэ үү.

  • Энэ дүрэм шуудангийн хайрцгийн жагсаалт харах болон тусдаа имэйл уншихад хамаарахгүй. API түлхүүрийн өдрийн болон нийт квот бие даан үйлчилсээр байна. 10 секунд хүлээх нь дууссан түлхүүрийн квотыг сэргээдэггүй.

Үндсэн endpoint-ууд

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
/api/emails/clear?email=...

Хайрцаг дахь бүх захиаг устгах.

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) Тогтмол угтвартай үүсгэх (жш. 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-аар нэг захиаг устгах

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