api
مركز المطورين وواجهات الـ API
بنية تحتية سريعة ومحمية عبر خوادم Cloudflare Workers لتوليد البريد المؤقت وجلب الرسائل بسرعة عالية ودعم كامل لـ CORS.
حساب المطور
سجل دخولك من القالب لتوليد مفتاح API التلقائي
/domains
جلب النطاقات
استرجاع جميع النطاقات المتاحة حالياً على السيرفر لإنشاء الحسابات عليها.
curl -X GET https://fakemail-api.cybenode-site.workers.dev/domains
/accounts
إنشاء حساب
إنشاء حساب بريد إلكتروني جديد على النطاقات المتاحة عبر إرسال JSON Body.
fetch('https://fakemail-api.cybenode-site.workers.dev/accounts', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
address: 'user123@domain.com',
password: 'Password123'
})
}).then(r => r.json()).then(console.log);
/token
توليد التوكين
استخراج JWT Bearer Token الموثق للوصول لصندوق الرسائل الواردة.
import requests
url = "https://fakemail-api.cybenode-site.workers.dev/token"
payload = {"address": "user123@domain.com", "password": "Password123"}
res = requests.post(url, json=payload)
print(res.json())
/messages
جلب الرسائل
جلب كافة الرسائل الواردة بتمضية التوكين في الهيدر `Authorization: Bearer TOKEN`.
curl -X GET https://fakemail-api.cybenode-site.workers.dev/messages \ -H "Authorization: Bearer YOUR_TOKEN"
مختبر الاستجابة المباشر (API Playground)
قم بتنفيذ طلب حي ومباشر إلى الـ Cloudflare Worker لمشاهدة الاستجابة التلقائية:
// اضغط على أحد الأزرار بالأعلى للبدء...
مكتبة JavaScript SDK الرسمية (CybeNodeMail.js)
قم بنسخ هذه الكلاس الجاهزة واستخدامها مباشرة في مشروعك:
class CybeNodeMail {
constructor(baseUrl = "https://fakemail-api.cybenode-site.workers.dev") {
this.baseUrl = baseUrl;
this.token = null;
}
async getDomains() {
const res = await fetch(`${this.baseUrl}/domains`);
const data = await res.json();
return data["hydra:member"] || data;
}
async createRandomAccount() {
const domains = await this.getDomains();
const domain = typeof domains[0] === "string" ? domains[0] : domains[0].domain;
const address = `user_${Math.random().toString(36).substring(2, 8)}@${domain}`;
const password = "Pw_" + Math.random().toString(36).substring(2, 8);
await fetch(`${this.baseUrl}/accounts`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ address, password })
});
const tokenRes = await fetch(`${this.baseUrl}/token`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ address, password })
});
const tokenData = await tokenRes.json();
this.token = tokenData.token;
return { address, password, token: this.token };
}
async getMessages(token = this.token) {
const res = await fetch(`${this.baseUrl}/messages`, {
headers: { Authorization: `Bearer ${token}` }
});
const data = await res.json();
return data["hydra:member"] || data;
}
}
جدول أكواد الاستجابة والأخطاء (HTTP Status Codes)
| الرمز | الوصف | التفاصيل |
|---|---|---|
200 OK |
تم بنجاح | تمت معالجة الطلب بنجاح واسترجاع البيانات المطلوبة. |
201 Created |
تم الإنشاء | تم إكتمال إنتاج الحساب البريدي بنجاح على النطاق. |
400 Bad Request |
طلب غير صالح | صيغة JSON غير صحيحة أو البيانات المطلوبة مفقودة. |
401 Unauthorized |
غير موثق | توكين المعرف مفقود أو انتهت صلاحيته. |
429 Rate Limit |
تجاوز الحد | تم تجاوز الحد الأقصى للاستدعاءات المسموح بها في الدقيقة. |
هل واجهتك مشكلة برمجية أو تحتاج لمساعدة؟
فريقنا التقني متواجد لمساعدتك في الربط، حل أسباب الأخطاء، أو استقبال بلاغات الأعطال فوراً.
اترك تعليقك هنا