Aller au contenu

Link Developer API · v1

Connectez les données Link réelles à votre produit.

Clés live avec scopes, ciblage par graphe de routes, QR et analytics. La référence est publique ; les clés, l’utilisation et le testeur se trouvent dans la console après connexion.

Créer une clé Démarrage rapide

Uniquement les clés bk_live_* · la propriété découle de la clé

terminalGET
$ curl api.beklio.com/api/v1/links?limit=2 \  -H "Authorization: Bearer bk_live_…"HTTP/1.1 200 OK · x-request-id: req_…{  "data": [    { "id": "lnk_…", "slug": "launch", "kind": "DIRECT" },    { "id": "lnk_…", "slug": "docs", "kind": "DIRECT" }  ],  "meta": { "requestId": "req_…" }}$

Pour commencer

En ligne en trois étapes.

De la création d’une clé à la production ; chaque étape renvoie vers le guide correspondant.

  1. 01

    Créez une clé

    Dans la console, générez une clé bk_live_ avec uniquement les scopes nécessaires.

    Ouvrir la console
  2. 02

    Envoyez la première requête

    Créez votre premier lien avec l’en-tête Authorization et un Idempotency-Key.

    Démarrage rapide
  3. 03

    Passez en production

    Gérez les codes d’erreur, les quotas et le comportement des nouvelles tentatives.

    Erreurs et limites

Ressources

Tout ce dont vous avez besoin.

Documentation10 guides : de l’authentification à la gestion des erreurs.
  • Démarrage rapide
  • Authentification et scopes
  • OAuth 2.0 et PKCE
  • Création et gestion des liens
Référence de l’API45 endpoints avec méthode, chemin et scope requis.
  • GET/api/v1/links
  • POST/api/v1/links
  • GET/api/v1/links/:id
  • PATCH/api/v1/links/:id
Console développeurClés, utilisation de l’offre et testeur d’API en direct.
Productionbk_live_•••••••• Actif
OutilsTéléchargez le schéma OpenAPI et la collection Postman, et testez des requêtes avec le testeur d’API.beklio-link-openapi.jsonCollection Postman

Autorisation

Privilège minimal, par défaut.

Chaque clé ne fonctionne qu’avec les scopes que vous avez choisis ; les requêtes avec un scope manquant sont refusées avec un 403.

Guide d’authentification
  • links:readLecture des liens, trees, boards, dossiers, routes et QR.
  • links:writeCréation, mise à jour, sous-ressources de route et écriture du QR.
  • links:deleteSuppression des liens et des sous-ressources.
  • analytics:readDonnées d’analytics de vos propres liens.
  • domains:readLecture des métadonnées de domaine.