تخطي إلى المحتوى
مرجع الواجهة

واجهة 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جرى فتح رابط مُعاد كتابته.

الأسئلة الشائعة