Aller au contenu
DocumentationAideENOuvrir mon Rynqu

Référence API → Liens

POST/api/bookmarks

Créer un lien

Sauvegarde une URL dans ta bibliothèque Rynqu. L'IA prend la main en arrière-plan pour générer le titre, le résumé, les tags et le screenshot — le lien est accessible immédiatement avec le statut pending.

Cycle de vie d'un lien

pending→
processing→
ready

Le champ status évolue de pending → processing → ready une fois le traitement IA terminé (généralement 5 à 30 secondes).

Paramètres de la requête

ParamètreTypeRequisDescription
urlstringrequisL'URL à sauvegarder. Doit être une URL valide et accessible.
folderIdstring (uuid)optionnelIdentifiant du dossier de destination. Si absent, Rynqu classe automatiquement le lien.
isFavoritebooleanoptionnelMarque le lien comme favori dès sa création. Défaut : false.

Exemple de requête

curl -X POST https://rynqu.com/api/bookmarks \
  -H "Authorization: Bearer sk_xxxx" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/article"}'

Réponse — 201 Created

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "url": "https://example.com/article",
  "title": "Example Domain",
  "description": "This domain is for use in illustrative examples.",
  "summary": null,
  "imageUrl": null,
  "screenshotUrl": null,
  "type": null,
  "status": "pending",
  "folderId": null,
  "isFavorite": false,
  "createdAt": "2026-05-06T12:00:00.000Z",
  "updatedAt": "2026-05-06T12:00:00.000Z"
}

Les champs summary, imageUrl, screenshotUrl et type sont null initialement — ils se remplissent au fil du traitement IA.

Erreurs possibles

401UNAUTHORIZEDClé API absente ou invalide.
400INVALID_URLURL manquante ou non valide.
403FORBIDDENQuota de liens du plan dépassé.
429RATE_LIMIT_EXCEEDEDTrop de requêtes — attendez la remise à zéro.

Suivant

Lister les liens

Voir l'endpoint