- Documentation
- API · Version 1.0
- Marques et destinations
Marques et destinations
Sur cette page
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
}
]
}
timezoneest le fuseau par défaut des publications de la marque.pausedvauttruequand 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_limitetmonthly_delivery_limitsont les quotas de la marque : ceux de l'offre de l'espace, sauf exception propre à la marque.nullsignifie « 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 |
|---|---|---|---|---|---|---|
| 63 206 | oui | 1 | non | oui | non | |
| 2 200 | non | 1 | oui | oui | non | |
| 3 000 | oui | 1 | non | oui | non | |
| Threads | 500 | oui | 1 | non | oui | non |
| 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.