Links erstellen und verwalten

Link-Arten, Kurzform und vollständiger Route-Graph, Aktualisieren und Löschen.

1 Min. Lesezeit 3 Abschnitte

Ein Link ist ein Routing-Graph mit einer oder mehreren Routes. Die kind-Werte sind DIRECT, TREE, TREE_ITEM, BOARD und BOARD_ITEM; routingMode kann SIMPLE oder ADVANCED sein.

Kurzform#

Für Links mit nur einer Ziel-URL genügt das Feld url:

POST /api/v1/links

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

Vollständiger Route-Graph#

Senden Sie für zielgruppenspezifische Links das Array routes. Bei Verwendung des vollständigen Graphen müssen mindestens eine Route und ein globaler Fallback definiert sein.

POST /api/v1/links

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

actionType-Werte: URL, SMS, WHATSAPP, EMAIL, EVENT, EMBED.

Lesen, aktualisieren, löschen#

Methode	Pfad	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`

Beim Löschen werden auch die mit dem Link verbundenen Graph-Ressourcen entfernt. Zur Route-Auswahl und zum Targeting siehe die Seite Routing.

Fehlt etwas oder ist etwas falsch? Schreiben Sie dem Support-Team; die Angabe des X-Request-Id-Werts aus der Antwort beschleunigt die Lösung.