Перейти к содержимому
Справочник API

REST API Skrybo

Один базовый URL, один bearer-токен, семь эндпоинтов. Тот же формат POST /v1/emails что и у Resend — для перехода достаточно сменить базовый URL. Полная документация находится в /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_…ваш ключ API разработчика
События вебхуков

Standard Webhooks, HMAC-SHA256

СобытиеКогда срабатывает
email.sentРелей принял сообщение.
email.deliveredMTA получателя подтвердил доставку.
email.bouncedОкончательный отказ (адрес добавлен в подавление).
email.complainedПолучатель пометил письмо как спам.
email.openedЗагружен пиксель отслеживания.
email.clickedПерешли по переписанной ссылке.

Частые вопросы