مرجع الواجهة
واجهة REST في Skrybo
عنوان أساسي واحد، ورمز bearer واحد، وسبع نقاط نهاية. البنية نفسها POST /v1/emails المستخدمة في Resend — وللانتقال يكفي تغيير العنوان الأساسي. والتوثيق الكامل موجود ضمن /docs.
إرسال رسالة
POST /v1/emails
curl
curl -X POST https://api.skrybo.com/v1/emails \
-H "Authorization: Bearer skrybo_live_xxx" \
-H "Content-Type: application/json" \
-d '{"from":"you@your-domain.com","to":["a@b.com"],"subject":"Hi","html":"<p>Hi</p>"}'JavaScript
import { Skrybo } from "skrybo";
const s = new Skrybo(process.env.SKRYBO_API_KEY);
await s.emails.send({
from: "you@your-domain.com",
to: ["a@b.com"],
subject: "Hi",
html: "<p>Hi</p>",
});Python
from skrybo import Skrybo
s = Skrybo(api_key=os.environ["SKRYBO_API_KEY"])
s.emails.send(
from_="you@your-domain.com",
to=["a@b.com"],
subject="Hi",
html="<p>Hi</p>",
)نقاط النهايةكل ما يقع تحت
كل ما يقع تحت /v1
| الأسلوب | المسار | الغرض |
|---|---|---|
POST | /v1/emails | إرسال رسالة معاملات واحدة (بنية متوافقة مع Resend). |
POST | /v1/emails/batch | إرسال حتى 100 رسالة في طلب واحد. البنية نفسها. |
GET | /v1/emails/:id | الاستعلام عن حالة التسليم والفتح والنقر والارتداد. |
GET | /v1/audiences | عرض جماهير الحساب. |
POST | /v1/audiences | إنشاء جمهور جديد للحملات. |
POST | /v1/audiences/:audienceId/contacts | إضافة جهة اتصال إلى جمهور. |
GET | /v1/audiences/:audienceId/contacts | عرض جهات الاتصال داخل جمهور. |
GET | /v1/suppressions | عرض قيود الحجب مع السبب وcreated_at. |
POST | /v1/suppressions | إضافة عنوان إلى قائمة الحجب لديك. |
مرحّل SMTP
بروتوكول SMTP قياسي ومنافذ قياسية
- المضيف:
smtp.skrybo.com - المنفذ: 587 (STARTTLS) أو 465 (TLS ضمني)
- اسم المستخدم:
apikey - كلمة المرور:
skrybo_live_…— مفتاح واجهة المطورين الخاص بك
أحداث خطافات الويب
Standard Webhooks بترميز HMAC-SHA256
| الحدث | متى يُطلق |
|---|---|
email.sent | قبل المرحّل الرسالة. |
email.delivered | أكّد خادم بريد المستلم التسليم. |
email.bounced | ارتداد نهائي (أُضيف العنوان إلى قائمة الحجب). |
email.complained | صنّف المستلم الرسالة بريدًا مزعجًا. |
email.opened | جرى تحميل بكسل التتبّع. |
email.clicked | جرى فتح رابط مُعاد كتابته. |