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

གདམ་ག ༢། རང་ཉིད་ཀྱི domain་ཁ་སྣོན།

སྤྱི་པའི་དྲ་མིང་གི MX ཞིབ་བཤེར་ལེགས་གྲུབ་རྗེས། ཐོ་མ་འཇུག་པར་བཏང་བ → API ལྡེ་མིག (རེ་ཞུ་20000)། ཐོ་འཇུག་བྱས་ཏེ་བཏང་བ → སྐར་མ་200། དྲ་མིང་རེར་བྱ་དགའ་གཅིག་ཁོ་ན་ཐོབ། གལ་ཆེ། མཐུད་སྦྲེལ་བྱས་རྗེས། domain དེའི་མཇུག་རྟགས་འདི་ས་གནས་འདིའི་སྤྱོད་མཁན་ཡོངས་ལ་ཁྱབ་པའི་སྤྱི་པའི་མཇུག་རྟགས་སུ་འགྱུར། དེས་སྤྱོད་མཁན་གཞན་གྱིས་ཀྱང་དེའི་འོག་ཏུ་སྒྲོམ་གྱི་ཁ་བྱང་བཟོ་ཆོག བྱེད་ནུས་སྤར་རྗེས། domain འདི་ང་ཚོའི་ཞབས་ཞུར་མཛུབ་སྟོན་བྱེད་པའི MX record སུབ་པ། བརྗེ་བ། ཡང་ན་བཟོ་བཅོས་བྱེད་མི་རུང་། མི་ནུས་ན། ཕྱིས་ཀྱི་ཞིབ་བཤེར་གྱིས domain སྒྲིག་བཀོད་ནོར་བར་བརྩི་སྲིད། ཕྱིས་ཀྱི་ཞིབ་བཤེར་གྱིས MX record ནུས་མེད་ཤེས་ན། domain བྱེད་ནུས་མེད་དུ་འགྱུར། MX record 3་ཞིབ་བཤེར་རྗེས་མཉམ་དུ་ནུས་མེད་ཡིན་ན། འབྲེལ་ཡོད API Key ཡང་བྱེད་ནུས་མེད་དུ་འགྱུར། ཕྱིས MX record ཡང་བསྐྱར་ནུས་ལྡན་ཡིན་ན། domain རང་འགུལ་གྱིས་བསྐྱར་དུ་བྱེད་ནུས་ཡོད་པར་འགྱུར།

ཡུལ་མིང་།

སྤྱི་པའི་ཚོད་ལྟའི་ལྡེ་མིག

ཚོད་ལྟའི་ཆེད་དུ། གཤམ་དུ་མངོན་པའི་མཉམ་སྤྱོད་སྤྱི་པའི་ལྡེ་མིག་དེ་ X-API-Key མགོ་ཡིག་ནང་བསྐུར་རོགས། ལྡེ་མིག་དེ་ཉིན་རེར་བསྒྱུར་ཞིང་། སྤྱོད་མཁན་ཡོངས་ཀྱིས་མཉམ་སྤྱོད་བྱེད་པའི་ཉིན་རེའི་རེ་ཞུའི་ཚད་བཀག་ 200,000 ཡོད།

དེ་རིང་ལྷག་ཡོད།

བསྐྱར་འཛུགས་དུས་ཚོད།

སྤྱི་པའི key གྱི་ད་ལྟའི་ཚད་བཀག་འཇུག་བཞིན་པ།...

འོག་གི 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 གནས་ཁོངས་ཡོད། API ལྡེ་མིག་སྤྱད་ན་ usage ཡང་ཚུད། Cloudflare ཡི་ནོར་འཁྲུལ་ལན་འདེབས་ལ་ཚད་བཀག་ལན་འདེབས་ཚུད་པ་དང་ HTML ལན་འདེབས་བྱེད་སྲིད། JSON དབྱེ་ཞིབ་མ་བྱས་གོང་ HTTP གནས་ཚུལ་དང་ Content-Type ལ་ཞིབ་བཤེར་བྱེད་རོགས།

  • གལ་ཏེ་ཁྱེད་ལ་ས་གནས་འདིར་ད་ལྟ་རྒྱབ་སྐྱོར་བྱེད་པའི domain ཤེས་ན། འཕྲིན་ཡིག་བཟོ་བའི་མཐུད་སྦྲེལ་སྔོན་ལ་འབོད་མི་དགོས། ཁྱེད་ཀྱིས་ས་གནས་སུ prefix@domain་སྒྲིག་ནས་སྒྲོམ API ཐད་ཀར་འབོད་ཆོག དེས API request་གཅིག་ཆུང་དུ་གཏོང་།

མྱུར་ཚད་ཚད་བཀག་དང་བསྐྱར་ཚོད།

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

སྒྲོམ་ནང་གི་འཕྲིན་ཡིག་ཡོངས་སུབ།

GET
/api/stats

ས་ཁོངས་ཡོངས་ཀྱི་ཐོན་ཚད་ཀློག་པ།

དཔེ་མཚོན་རྒྱུན་ལྡན།

འོག་ཏུ་རྒྱུན་སྤྱོད་གཉིས་ཡོད། ཞབས་ཞུས་ཁྱེད་ཀྱི་ཆེད་དུ་འཕྲིན་སྒམ་བཟོ་བར་བཞག་པ། ཡང་ན་ངེས་གཏན་གྱི་མགོ་སྦྱོར་ཞུ་བ། གལ་ཏེ་ཁྱེད་ལ་ད་ལྟ་རྒྱབ་སྐྱོར་བྱེད་པའི 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) ངེས་གཏན་གྱི་མགོ་སྦྱོར་དང་བཟོ་བ། (དཔེ། 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 ཤེས་ན། བཅུག་རིམ ༡ བརྒལ་ནས་ཐད་ཀར་འདྲི་བ།

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 ཤུགས་ཆེ་ཤོས་ཀྱི domain སློག་པ།
  • /api/statistics/top-senders ཤུགས་ཆེ་ཤོས་ཀྱི་འཕྲིན་སྐུར་བ་སློག་པ།
GPTMail