Справочник 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.delivered | MTA получателя подтвердил доставку. |
email.bounced | Окончательный отказ (адрес добавлен в подавление). |
email.complained | Получатель пометил письмо как спам. |
email.opened | Загружен пиксель отслеживания. |
email.clicked | Перешли по переписанной ссылке. |