Passer au contenu
Référence de l'API

L'API REST de Skrybo

Une URL de base, un jeton bearer, sept points d'entrée. Le même format POST /v1/emails que Resend — pour migrer, changez l'URL de base. La documentation complète se trouve sous /docs.

Envoyer un message

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>",
)
Points d'entrée

Tout ce qui vit sous /v1

MéthodeCheminRôle
POST/v1/emailsEnvoyer un e-mail transactionnel unique (format compatible Resend).
POST/v1/emails/batchEnvoyer jusqu'à 100 messages en une requête. Même format.
GET/v1/emails/:idConsulter l'état de livraison, les ouvertures, les clics et les rejets.
GET/v1/audiencesLister les audiences du compte.
POST/v1/audiencesCréer une audience pour les campagnes.
POST/v1/audiences/:audienceId/contactsAjouter un contact à une audience.
GET/v1/audiences/:audienceId/contactsLister les contacts d'une audience.
GET/v1/suppressionsLister les suppressions avec le motif et created_at.
POST/v1/suppressionsAjouter une adresse à votre liste de suppressions.
Relais SMTP

SMTP standard, ports standards

  • Hôte : smtp.skrybo.com
  • Port : 587 (STARTTLS) ou 465 (TLS implicite)
  • Nom d'utilisateur : apikey
  • Mot de passe : skrybo_live_… — votre clé d'API développeur
Événements de webhook

Standard Webhooks, HMAC-SHA256

ÉvénementDéclenchement
email.sentMessage accepté par le relais.
email.deliveredLe MTA destinataire a confirmé la livraison.
email.bouncedRejet définitif (adresse supprimée).
email.complainedLe destinataire a signalé un spam.
email.openedLe pixel de suivi a été chargé.
email.clickedUn lien réécrit a été suivi.

Questions fréquentes