Création et gestion des liens

Types de liens, forme courte ou graphe de routes complet, mise à jour et suppression.

1 min de lecture 3 sections

Un lien est un graphe de routage contenant une ou plusieurs routes. Les valeurs de kind sont DIRECT, TREE, TREE_ITEM, BOARD et BOARD_ITEM ; routingMode peut valoir SIMPLE ou ADVANCED.

Forme courte#

Pour les liens ayant une seule URL de destination, le champ url suffit :

POST /api/v1/links

{
  "kind": "DIRECT",
  "domainId": "bekl.io",
  "url": "https://example.com/launch",
  "slug": "launch"
}

Graphe de routes complet#

Pour les liens ciblés, envoyez le tableau routes. Avec le graphe complet, au moins une route et un repli global (fallback) doivent être définis.

POST /api/v1/links

{
  "kind": "DIRECT",
  "domainId": "bekl.io",
  "routes": [{
    "platform": "GLOBAL",
    "actionType": "URL",
    "actionConfig": { "url": "https://example.com/release" },
    "isGlobalFallback": true
  }]
}

Valeurs de actionType : URL, SMS, WHATSAPP, EMAIL, EVENT, EMBED.

Lecture, mise à jour, suppression#

Méthode	Chemin	Scope
GET	`/api/v1/links`	`links:read`
GET	`/api/v1/links/:id`	`links:read`
PATCH	`/api/v1/links/:id`	`links:write`
DELETE	`/api/v1/links/:id`	`links:delete`

La suppression retire également les ressources du graphe rattachées au lien. Pour la sélection des routes et le ciblage, consultez la page Routage.

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.