Démarrage rapide

Créez votre première clé live et générez votre premier lien court avec l’API en cinq minutes.

1 min de lecture 3 sections

L’API Beklio Link Developer vous permet de gérer vos ressources Link avec des données réelles (live). Toutes les requêtes publiques passent par la passerelle (gateway) sous https://api.beklio.com/api/v1/links.

1. Créer une clé#

Connectez-vous à la console développeur et créez une clé bk_live_… avec uniquement les scopes dont vous avez besoin. Le secret n’est affiché qu’une seule fois, dans la réponse de création ; enregistrez-le immédiatement dans un gestionnaire de secrets.

2. Envoyer la première requête#

create-link.sh

curl -X POST "https://api.beklio.com/api/v1/links" \
  -H "Authorization: Bearer bk_live_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: launch-2026-001" \
  -d '{
    "kind": "DIRECT",
    "domainId": "bekl.io",
    "url": "https://example.com/launch",
    "slug": "launch"
  }'

La passerelle normalise les réponses dans une enveloppe { data, meta? }, et chaque réponse comporte un en-tête X-Request-Id.

3. Étapes suivantes#

Authentification et scopes — quelle opération exige quelle autorisation.
Création de liens — la différence entre la forme courte et le graphe de routes complet.
Erreurs et limites — le comportement des codes 401/403/409/429/503.

Dans les nouvelles intégrations, envoyez un Idempotency-Key unique avec chaque mutation ; en cas d’erreur réseau, vous pouvez réessayer en toute sécurité avec la même clé.

Il manque quelque chose ou il y a une erreur ? Écrivez à l’équipe d’assistance, en joignant la valeur X-Request-Id de la réponse, vous accélérerez la résolution.