API Reference

Copy// 201 Created { "success": true, "data": { "id": 1, "username": "myuser", "role": "user", "credits": 10, "token": "eyJhbG..." } }

Copy{ "success": true, "data": { "username": "myuser", "role": "user", "credits": 10, "token": "eyJhbGciOi..." } }

Copy// Header Authorization: Bearer eyJhbGciOi... // Hoặc Cookie (tự động set khi login qua web) Cookie: token=eyJhbGciOi...

Copy{ "success": true, "data": { "address": "[email protected]", "domain": "example.com", "expires_at": "2026-03-21T00:00:00Z", "credits_remaining": 9 } }

CopyX-Api-Key: tm_your_api_key

Copy{ "success": true, "data": { "address": "[email protected]", "credits_remaining": 99 } }

Copy{ "success": true, "data": { "address": "[email protected]", "message_count": 2, "messages": [{ "id": 1, "sender": "[email protected]", "subject": "Your verification code", "body_text": "Your code is 123456", "received_at": "2026-03-20T12:00:00Z" }] } }

Copy{ "success": true }

Copy{ "success": true, "data": { "provider": "Facebook", "otp_code": "123456", "source": "body", "sender": "[email protected]" } }

Copy// Connected data: {"type":"connected","address":"[email protected]"} // New message received data: {"type":"new_message","message":{"id":1,"sender":"...","subject":"...","otp":{"provider":"Facebook","otp_code":"123456"}}}

Copyconst source = new EventSource('/api/emails/[email protected]/stream'); source.onmessage = (event) => { const data = JSON.parse(event.data); if (data.type === 'new_message') { console.log('New email from:', data.message.sender); if (data.message.otp) { console.log('OTP:', data.message.otp.otp_code); } } };

CopyX-Api-Key: tm_your_api_key

Copyconst API = 'https://zuckmails.com'; const TOKEN = 'eyJ...your_token_here'; // from Dashboard async function getOTP() { // 1. Generate email const res = await fetch(`${API}/api/emails/generate`, { method: 'POST', headers: { 'Authorization': `Bearer ${TOKEN}` } }).then(r => r.json()); const addr = res.data.address; console.log('Email:', addr); // 2. Wait for OTP (max 60s) const otp = await fetch( `${API}/api/emails/${addr}/otp/wait?timeout=60` ).then(r => r.json()); if (otp.data) { console.log('OTP:', otp.data.otp_code); } else { console.log('No OTP received'); } } getOTP();

Copyimport requests API = "https://zuckmails.com" TOKEN = "eyJ...your_token_here" # from Dashboard headers = {"Authorization": f"Bearer {TOKEN}"} # 1. Generate email res = requests.post(f"{API}/api/emails/generate", headers=headers ).json() addr = res["data"]["address"] print(f"Email: {addr}") # 2. Wait for OTP otp = requests.get( f"{API}/api/emails/{addr}/otp/wait", params={"timeout": 60} ).json() if otp["data"]: print(f"OTP: {otp['data']['otp_code']}") else: print("No OTP received")

Copyusing System.Net.Http; using System.Net.Http.Json; using System.Text.Json; var client = new HttpClient(); var api = "https://zuckmails.com"; var token = "eyJ...your_token_here"; // from Dashboard client.DefaultRequestHeaders.Add( "Authorization", $"Bearer {token}"); // 1. Generate email var genRes = await client.PostAsync( $"{api}/api/emails/generate", null); var genData = await genRes.Content .ReadFromJsonAsync<JsonElement>(); var addr = genData .GetProperty("data") .GetProperty("address").GetString(); Console.WriteLine($"Email: {addr}"); // 2. Wait for OTP var otpRes = await client.GetFromJsonAsync<JsonElement>( $"{api}/api/emails/{addr}/otp/wait?timeout=60"); if (otpRes.GetProperty("data") .ValueKind != JsonValueKind.Null) { var code = otpRes.GetProperty("data") .GetProperty("otp_code").GetString(); Console.WriteLine($"OTP: {code}"); }