API Documentation

استخدم الـ API Key في كل الطلبات كـ query parameter

المصادقة (Auth)

POST /api/auth/register
تسجيل حساب جديد — Body: {"email":"...","password":"..."}
POST /api/auth/login
تسجيل دخول — يرجع JWT token و API Key

المستخدم

GET /api/user/balance?api_key=XXX
الرصيد الحالي
GET /api/user/profile?api_key=XXX
بيانات الحساب
GET /api/user/apikey?api_key=XXX
الـ API Key

البريد

GET /api/mail/create?api_key=XXX&prefix=abc
إنشاء إيميل جديد (مجاني) — prefix اختياري
GET /api/mail/code?api_key=XXX&email=xxx@admingmail.com
آخر كود تحقق (محفوظ سنة)
GET /api/mail/inbox?api_key=XXX&email=xxx@admingmail.com
صندوق الوارد (24 ساعة)
GET /api/mail/codes?api_key=XXX&email=xxx@admingmail.com
سجل كل الأكواد (سنة)

مثال (Python)

import requests

API = "https://gmaily.net"
KEY = "gm_your_api_key"

# Create email
r = requests.get(f"{API}/api/mail/create?api_key={KEY}")
email = r.json()["email"]
print(f"Email: {email}")

# Wait for code
import time
for _ in range(60):
    r = requests.get(f"{API}/api/mail/code?api_key={KEY}&email={email}")
    if r.json()["status"] == "found":
        print(f"Code: {r.json()['code']}")
        break
    time.sleep(5)