API et serveur MCP

Créez des jetons dans votre espace, rubrique Développeurs. Chaque jeton a des droits limités et peut être révoqué à tout moment.

Authentification

Authorization: Bearer rl_live_…

Réponses en JSON. Erreurs : { "error": { "code", "message" } }. Limite de débit selon la formule (Solo 20, Pro 60, Agence 120 requêtes par minute) et 1 requête par seconde au plus, indiquées dans les en-têtes X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Burst. Au-delà : 429 avec Retry-After. Service très sollicité : 503 avec Retry-After. Pour créer beaucoup de liens, utilisez /v1/links/batch.

Créer un lien

curl https://api.reli.es/v1/links \
  -H "Authorization: Bearer rl_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://exemple.fr/offre",
    "slug": "offre-hiver",
    "tags": ["sms"],
    "utm": {"source": "sms", "campaign": "hiver"},
    "expires_at": "2026-12-31T23:59:00+01:00"
  }'

201 Created
{ "data": { "id": 42, "short_url": "https://reli.es/offre-hiver", "status": "active", "clicks": 0, "qr_svg": "https://api.reli.es/v1/links/42/qr.svg", … } }

Points d’accès

Méthode	Chemin	Droit	Rôle
POST	`/v1/links`	`links:write`	Créer un lien : url, domain, slug, title, tags, utm, starts_at, expires_at, expired_url, password
POST	`/v1/links/batch`	`links:write`	Créer jusqu’à 100 liens : { "links": [ … ] }
GET	`/v1/links`	`links:read`	Lister : tag, status, domain, q, cursor, limit (100 au plus)
GET	`/v1/links/{id}`	`links:read`	Lire un lien
PATCH	`/v1/links/{id}`	`links:write`	Modifier destination, titre, tags, dates, UTM
DELETE	`/v1/links/{id}`	`links:write`	Archiver (la fin de lien n’est jamais réattribuée)
GET	`/v1/links/{id}/stats`	`stats:read`	Statistiques : days (7 à 365)
GET	`/v1/links/{id}/qr.svg`	`links:read`	QR code SVG ou PNG
GET	`/v1/domains`	`domains:read`	Domaines utilisables
GET · PATCH	`/v1/pages/{handle}`	`pages:read · pages:write`	Lire une page bio, modifier titre et présentation
GET	`/v1/account`	—	Formule, limites et consommation
GET · POST · PATCH	`/v1/campaigns` · `/v1/campaigns/{id}/contacts`	`campaigns:read · campaigns:write`	Campagnes des comptes gérés par Le Web 2 KS : un lien par contact

Webhooks

Événements : link.created, link.blocked, link.clicked (groupé par minute), page.form_submitted, campaign.contact_clicked (comptes gérés). Chaque envoi porte l’en-tête X-Relies-Signature : t=horodatage,v1=signature, où la signature est le HMAC-SHA256 de « horodatage.corps » avec votre secret. Refusez les envois de plus de 5 minutes. Trois nouvelles tentatives en cas d’échec : après 1 minute, 10 minutes, 1 heure.

$payload = file_get_contents('php://input');
[$t, $v1] = sscanf($_SERVER['HTTP_X_RELIES_SIGNATURE'], 't=%d,v1=%s');
$valid = abs(time() - $t) < 300
    && hash_equals(hash_hmac('sha256', $t.'.'.$payload, $secret), $v1);

Serveur MCP

Adresse : https://api.reli.es/mcp · transport HTTP, même jeton que l’API.

claude mcp add --transport http reli-es https://api.reli.es/mcp \
  --header "Authorization: Bearer rl_live_…"

Outil	Rôle
`liens_creer`	Créer un ou plusieurs liens
`liens_chercher`	Chercher par destination, tag, état
`liens_stats`	Statistiques d’un lien ou du compte
`lien_modifier`	Modifier destination, titre, tags, dates
`lien_archiver`	Archiver, avec confirmation explicite
`page_lire` · `page_modifier`	Lire une page bio, ajouter un bouton de lien
`qr_exporter`	Adresse du QR code SVG ou PNG
`compte_etat`	Formule, limites et consommation