Référence API

Vue d'ensemble

Tout ce qu'il faut savoir avant d'envoyer ton première requête — authentification, limites, format des réponses et codes d'erreur.

URL de base

https://rynqu.com

Tous les endpoints sont accessibles depuis cette racine. L'API n'a pas de préfixe de version pour l'instant.

Authentification

Chaque requête doit inclure ta clé API dans l'en-tête Authorization. Génère une clé depuis Dashboard → Paramètres → Clés API.

Authorization: Bearer sk_xxxxxxxxxxxxxxxxxxxx

Ne partagez jamais ta clé. En cas de compromission, révoquez-la immédiatement depuis les paramètres — une nouvelle clé sera générée instantanément.

Limites de taux

Plan	Requêtes / minute
Free	20 req/min
Pro	60 req/min

Chaque réponse inclut des en-têtes pour suivre ton consommation en temps réel :

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 57
X-RateLimit-Reset: 1746528000

X-RateLimit-Reset est un timestamp Unix (secondes) indiquant la prochaine remise à zéro du compteur.

Format des réponses

Toutes les réponses sont en JSON. Le contenu dépend de l'endpoint (voir les pages dédiées).

Succès

HTTP/1.1 200 OK
Content-Type: application/json

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "url": "https://example.com",
  "title": "Example Domain",
  "status": "ready",
  ...
}

Erreur

HTTP/1.1 401 Unauthorized
Content-Type: application/json

{
  "error": "UNAUTHORIZED",
  "message": "Clé API absente ou invalide."
}

Codes d'erreur

Code	HTTP	Description
UNAUTHORIZED	401	Clé API absente ou invalide.
FORBIDDEN	403	Quota du plan dépassé (ex. limite de liens).
NOT_FOUND	404	La ressource demandée n’existe pas ou ne t’appartient pas.
INVALID_URL	400	L'URL fournie est absente ou malformée.
VALIDATION_ERROR	400	Le corps de la requête ne respecte pas le schéma attendu.
RATE_LIMIT_EXCEEDED	429	Trop de requêtes — patientez avant de réessayer.
INTERNAL_ERROR	500	Erreur serveur inattendue. Réessayez ou contactez le support.

Commencer par

Créer un lien

Voir l'endpoint

Cette page t’a aidé ?