Aller au contenu
Quiet Social

Marques et destinations

Une marque est ce pour quoi vous publiez : une entreprise, un client, un produit. Une destination est un compte précis sur lequel une marque publie : une Page Facebook, un compte Instagram professionnel, une Page LinkedIn, un compte Threads ou un tableau Pinterest.

Les connexions aux réseaux et le rattachement des destinations à une marque se font dans le tableau de bord (voir le guide). L'API les lit ; elle ne les crée pas.

GET /brands

Les marques que le client peut voir, triées par nom. Un client rattaché à une marque n'en voit qu'une.

Périmètre requis : brands:read.

curl https://quietsocial.dev/api/v1/brands \
  -u "$QUIET_CLIENT_ID:$QUIET_CLIENT_SECRET"
{
  "data": [
    {
      "id": "brd_01k4b8x2q9r7f3m5t6v8w0y2z4",
      "name": "Fabrique du Nord",
      "timezone": "Europe/Paris",
      "locale": "fr",
      "status": "active",
      "paused": false,
      "monthly_publication_limit": 1000,
      "monthly_delivery_limit": 5000
    }
  ]
}
  • timezone est le fuseau par défaut des publications de la marque.
  • paused vaut true quand un administrateur a mis les envois de la marque en pause : une publication créée ou programmée pendant la pause est acceptée, mais ne part qu'à la reprise.
  • monthly_publication_limit et monthly_delivery_limit sont les quotas de la marque : ceux de l'offre de l'espace, sauf exception propre à la marque. null signifie « sans limite ».
  • La liste n'est pas paginée.

Codes : 200, 401, 403, 429.

GET /destinations

Les destinations visibles par le client, triées par nom.

Périmètre requis : destinations:read.

Paramètre Type Défaut Note
brand_id brd_… Ne rend que les destinations de cette marque. Une marque hors de portée rend une liste vide.
per_page entier 25 Entre 1 et 100.
page entier 1
curl "https://quietsocial.dev/api/v1/destinations?per_page=50" \
  -u "$QUIET_CLIENT_ID:$QUIET_CLIENT_SECRET"
{
  "data": [
    {
      "id": "dst_01k4b8x2q9r7f3m5t6v8w0y2z4",
      "brand_id": "brd_01k4b8x2q9r7f3m5t6v8w0y2z4",
      "network": "facebook",
      "name": "Fabrique du Nord",
      "username": "fabriquedunord",
      "avatar_url": "https://scontent.example/avatar.jpg",
      "status": "active",
      "can_publish": true,
      "capabilities": {
        "text": true,
        "link": true,
        "image": true,
        "maximum_text_length": 63206,
        "maximum_media_count": 1,
        "requires_media": false,
        "alt_text": true,
        "first_comment": false,
        "title": false
      },
      "synchronized_at": "2026-09-30T04:40:12+00:00"
    }
  ],
  "links": { "first": "…", "last": "…", "prev": null, "next": null },
  "meta": { "current_page": 1, "from": 1, "last_page": 1, "path": "…", "per_page": 50, "to": 1, "total": 1, "links": ["…"] }
}

La pagination est décrite dans Limites et conventions.

Codes : 200, 401, 403, 429.

GET /destinations/{id}

Périmètre requis : destinations:read.

La réponse est le même objet, enveloppé dans data. Une destination d'une autre marque répond 404.

Codes : 200, 401, 403, 404, 429.

Lire une destination

network

Le nom court du réseau. C'est la valeur qu'attend overrides à la création d'une publication, et celle que rendent les cibles d'une publication.

network Destination
facebook Page Facebook
instagram Compte Instagram professionnel
linkedin Page LinkedIn
threads Compte Threads
pinterest Tableau Pinterest

status et can_publish

status vaut active, disabled (désactivée par un membre de l'équipe) ou unavailable (le réseau ne la donne plus, ou la connexion a été révoquée).

can_publish est vrai seulement si la destination est active, que son propre jeton n'a pas expiré et que la connexion qui la porte est active. Une Page active rattachée à une connexion révoquée n'est pas publiable. Une publication vers une destination dont can_publish est faux est refusée à la création.

capabilities

Ce que la destination accepte, pour composer sans se faire refuser :

Champ Sens
text Accepte un texte.
link Accepte un lien (link_url).
image Accepte une image.
maximum_text_length Longueur maximale du texte, en caractères.
maximum_media_count Nombre maximal d'images.
requires_media Une image est obligatoire.
alt_text Le texte alternatif d'une image est transmis au réseau.
first_comment Un premier commentaire peut être publié sous le post. Faux partout aujourd'hui.
title Le post porte un titre visible, distinct du texte (le titre d'un Pin).

Les capacités sont recalculées à chaque synchronisation de la destination : lisez-les plutôt que de les recopier. Valeurs actuelles :

Réseau Texte max. Lien Images max. Image obligatoire Texte alternatif Titre
Facebook 63 206 oui 1 non oui non
Instagram 2 200 non 1 oui oui non
LinkedIn 3 000 oui 1 non oui non
Threads 500 oui 1 non oui non
Pinterest 800 oui 1 oui oui oui

La longueur du texte se compte comme le réseau la compte : hashtags ajoutés compris (sauf sur Threads), après échappement des caractères réservés sur LinkedIn, et sur Threads chaque emoji compte pour son nombre d'octets UTF-8 (😀 pour 4).

Chaque réseau impose en plus ses propres règles sur l'image elle-même ; elles sont vérifiées avant l'envoi et détaillées dans le guide.