links

Crée un lien court. Sans `parentId`, c'est un lien parent et `destination` est obligatoire. Avec `parentId`, c'est un placement : il hérite de la destination du parent et porte ses propres UTM. Renvoie `shortUrl`, prêt à publier.

post/api/v1/links

Request

  • Base URL: https://subtraq.co
  • URL: https://subtraq.co/api/v1/links
  • Auth: HTTP bearer

Request body

spacestring required

Raccourci de l'espace client.

destinationstring

URL d'arrivée. Obligatoire pour un parent, interdite pour un placement.

parentIdstring

Identifiant du lien parent, pour créer un placement.

slugstring

Raccourci souhaité. Tiré au sort s'il est omis.

labelstring

Nom du placement, par exemple « Pub Meta — mars ».

utmSourcestring

utm_source du placement.

utmMediumstring

utm_medium du placement.

utmCampaignstring

utm_campaign du placement.

utmTermstring

utm_term du placement.

utmContentstring

utm_content du placement.

domainstring

Adresse qui porte le lien (« liens.votresite.fr »). Omise = le même choix que l'écran de création : le domaine de marque réservé à l'espace, sinon l'unique domaine de marque du compte, sinon l'adresse offerte de l'espace (« client.sbtq.link ») ; pour un placement, le domaine de son parent. Pour le domaine partagé, le nommer : « sbtq.link » (la valeur domain d'un lien partagé). Un domaine de marque doit être vérifié dans le compte, et libre pour cet espace.

Response

Succès.

Changes

No recorded changes to this operation across all 1 revision of this API.