API hujjatlari

GPTMail API

GPTMail API yordamida HTTPS orqali X-API-Key sarlavhasi bilan vaqtinchalik kiruvchi qutilar yarating, xatlar ro‘yxatini oling, ularni o‘qing va o‘chiring. U avtomatlashtirilgan testlar, CI/CD konveyerlari va QA ish jarayonlari uchun mos keladi.

API Key qanday olinadi

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-variant: O‘z domeningizni qo‘shing

Ommaviy domen MX tekshiruvidan o‘tgach: tizimga kirmasdan yuborilgan bo‘lsa → API kaliti (20000 so‘rov); tizimga kirib yuborilgan bo‘lsa → 200 ball. Har bir domen faqat bitta mukofot oladi. Muhim: ulangach, shu domen qo‘shimchasi ushbu saytdagi barcha foydalanuvchilar uchun ochiq qo‘shimchaga aylanadi, boshqalar ham uning ostida pochta manzillarini yaratishi mumkin. Faollashtirgach, bu domenni xizmatimizga yo‘naltiruvchi MX yozuvini o‘chirmang, almashtirmang yoki o‘zgartirmang. Aks holda keyingi tekshiruvlar domenni noto‘g‘ri sozlangan deb hisoblashi mumkin. Keyingi tekshiruv MX ni yaroqsiz topsa, domen o‘chiriladi. MX 3 ketma-ket tekshiruvda yaroqsiz bo‘lsa, bog‘liq API Key ham o‘chiriladi. MX keyinroq yana yaroqli bo‘lsa, domen avtomatik qayta yoqiladi.

Domenlar

Ochiq sinov kaliti

Sinov uchun quyida ko‘rsatilgan umumiy ochiq kalitni X-API-Key sarlavhasida yuboring. U har kuni o‘zgaradi va barcha foydalanuvchilar birgalikda ishlatadigan kunlik 200 000 so‘rov limitiga ega.

Bugun qolgan

Qayta o‘rnatiladi

Ochiq kalit uchun jonli kvota yuklanmoqda...

Quyidagi API qo‘llanmasini Markdown sifatida AI vositalari, bilim bazalari yoki README uchun nusxalash mumkin.

Asosiy manzil: https://mail.chatgpt.org.uk

AI
llms.txt

·

llms-full.txt

(Markdown)

Tez boshlash

  • X-API-Key: YOUR_KEY eng oddiy usul. Tezkor sinovlar uchun YOUR_KEY o‘rniga yuqorida ko‘rsatilgan kunlik ochiq kalitdan foydalaning.

  • Ko‘pchilik pochta qutisi endpointlari email parametrini talab qiladi, masalan ?email=demo@example.com.

  • GPTMail API javoblari success, data va error maydonlariga ega JSON formatida bo‘ladi, API kaliti ishlatilganda esa usage maydoni ham qo‘shiladi. Cloudflare xatolari, jumladan so‘rovlar tezligi limiti javoblari, buning o‘rniga HTML qaytarishi mumkin. JSON ni tahlil qilishdan oldin HTTP holat kodi va Content-Type sarlavhasini tekshiring.

  • Ushbu saytda qo‘llab-quvvatlanadigan domenni bilasiz, avval xat yaratish endpointini chaqirish shart emas. Mahalliy ravishda prefix@domain tuzib pochta API larini to‘g‘ridan-to‘g‘ri chaqiring — bitta API request tejash.

So‘rovlar tezligi limitlari va qayta urinishlar

  • GET va POST /api/generate-email har bir manba IP manzili uchun 10 soniyada 30 ta so‘rovlik umumiy limitga ega. Bu ham ochiq, ham shaxsiy API kalitlariga taalluqli. Bir xil IP ortidagi turli kalitlar va mijozlar ushbu limitni birgalikda ishlatadi.

  • Ushbu limitdan oshilsa, HTTP 429 javobi qaytariladi va elektron pochta yaratish 10 soniyaga bloklanadi. Qayta urinishdan oldin Retry-After sarlavhasida ko‘rsatilgan vaqtni kuting. Agar bu sarlavha bo‘lmasa, kamida 10 soniya kuting, so‘ng kechikishlarni oshirib borgan holda qayta urining. Bitta IP manzilni birgalikda ishlatadigan mijozlardan bir vaqtda qayta urinishlardan saqlaning.

  • Bu qoida kiruvchi qutidagi xatlar ro‘yxatini olish yoki alohida xatlarni o‘qishga taalluqli emas. API kalitining kunlik va umumiy kvotalari bundan qat’i nazar amal qilishda davom etadi. 10 soniya kutish tugagan kalit kvotasini tiklamaydi.

Asosiy endpointlar

POST / GET
/api/generate-email

Vaqtinchalik pochta qutisini yarating. Eng oddiy tasodifiy oqim uchun GET yoki aniq boshqaruv kerak bo‘lsa prefix va domain bilan POST ishlating.

GET
/api/emails?email=...

Pochta qutisi uchun xatlarni olish.

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

Bitta xatni olish: matn, HTML, xom sarlavhalar va metadata.

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

ID bo‘yicha bitta xatni o‘chirish.

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

Pochta qutisidagi barcha xatlarni o‘chirish.

GET
/api/stats

Butun sayt statistikasini o‘qish.

Namuna oqimi

Quyida ikki keng tarqalgan usul bor: xizmatning siz uchun quti yaratishiga ruxsat bering yoki qat’iy prefiks so‘rang. Qo‘llab-quvvatlanadigan domenni allaqachon bilasiz, manzilni mahalliy tuzib to‘g‘ridan-to‘g‘ri so‘rash mumkin.

1) Tasodifiy vaqtinchalik elektron pochta manzilini yaratish

curl 'https://mail.chatgpt.org.uk/api/generate-email' \
  -H 'X-API-Key: PUBLIC_API_KEY'
Javob namunasi
{
  "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) Qat’iy prefiks bilan yaratish (mas. 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"}'
Javob namunasi
{
  "success": true,
  "data": {
    "email": "demo@example.com"
  },
  "usage": {
    "daily_limit": 200000,
    "used_today": 2,
    "remaining_today": 199998
  }
}

3) Pochta qutisidagi xatlarni ro‘yxatga olish

Qo‘llab-quvvatlanadigan domenni bilasiz, 1-qadamni o‘tkazib, to‘g‘ridan-to‘g‘ri so‘rang.

curl 'https://mail.chatgpt.org.uk/api/emails?email=demo@example.com' \
  -H 'X-API-Key: PUBLIC_API_KEY'
Javob namunasi
{
  "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) Bitta xatni o‘qish — oddiy matn, HTML tanasi va metadata

EMAIL_ID ni 3-qadamda qaytarilgan id bilan almashtiring. Kiruvchi quti manzilini ham email sifatida yuboring (o‘chirish va ilovalarni yuklab olishda ham): shunda xat ID bo‘yicha qidirilmaydi, balki to‘g‘ridan-to‘g‘ri o‘z kiruvchi qutisidan o‘qiladi. API kaliti bilan email parametri ixtiyoriy, lekin uni yuborish qidiruvni tezlashtiradi.

curl 'https://mail.chatgpt.org.uk/api/email/EMAIL_ID?email=demo@example.com' \
  -H 'X-API-Key: PUBLIC_API_KEY'
Javob namunasi
{
  "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 bo‘yicha bitta xatni o‘chirish

API kaliti bilan email parametri ixtiyoriy, lekin uni yuborish qidiruvni tezlashtiradi.

curl -X DELETE 'https://mail.chatgpt.org.uk/api/email/EMAIL_ID?email=demo@example.com' \
  -H 'X-API-Key: PUBLIC_API_KEY'
Javob namunasi
{
  "success": true,
  "data": {
    "message": "Email deleted"
  }
}

6) Butun qutini tozalash — ushbu manzil uchun barcha xatlarni o‘chiradi

Har bir chaqiruv bitta to‘plamni o‘chiradi. Javobda "has_more": true bo‘lsa, false qaytarguncha uni qayta chaqiring.

curl -X DELETE 'https://mail.chatgpt.org.uk/api/emails/clear?email=demo@example.com' \
  -H 'X-API-Key: PUBLIC_API_KEY'
Javob namunasi
{
  "success": true,
  "data": {
    "message": "Deleted 3 emails",
    "count": 3,
    "has_more": false
  }
}

Javob shakli

Muvaffaqiyatli javoblar odatda shunday ko‘rinadi. API Key bilan kirganingizda usage ichidagi kvotaga e’tibor bering.

{
  "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
  }
}

Kengaytirilgan statistika

  • /api/statistics/24h soatlik taqsimotning bitta 24 soatlik oralig‘ini qaytaradi; oldingi oraliqlar uchun offset=1,2,... dan foydalaning.
  • /api/statistics/top-subjects eng ko‘p uchraydigan xat mavzularini qaytaradi.
  • /api/statistics/top-domains eng faol domenlarni qaytaradi.
  • /api/statistics/top-senders eng faol yuboruvchilarni qaytaradi.
GPTMail