- Documentation
- API · Version 1.0
- Introduction
Introduction
Sur cette page
L'API REST de Quiet Social permet à votre application de publier sur les réseaux d'une marque sans passer par le tableau de bord : un article mis en ligne, un produit lancé ou un événement créé devient une publication, programmée ou immédiate, sur Facebook, Instagram, LinkedIn, Threads et Pinterest.
Rien ici ne demande de bibliothèque. Pour ne pas écrire les appels vous-même, le SDK PHP les fait pour n'importe quelle application PHP, et le paquet Laravel publie vos modèles Eloquent ; tout ce qu'ils font passe par cette API.
Adresse de base
https://quietsocial.dev/api/v1
La version est dans le chemin. Une URL porte donc sa version : un exemple copié de cette documentation reste valide, et une version 2 vivra à côté de la version 1, pas à sa place.
Format
- Les corps de requête et de réponse sont en JSON, sauf l'envoi d'un fichier, en
multipart/form-data. - Toute réponse sous
/api/est rendue en JSON, erreurs comprises. L'en-têteAccept: application/jsonest recommandé, il n'est pas nécessaire. - Les dates sont au format ISO 8601, avec leur décalage :
2026-10-01T09:30:00+00:00. - Les ressources sont désignées par un identifiant public préfixé —
pub_…,dst_…— jamais par un numéro. Voir Limites et conventions.
Premier appel
Créez une clé dans le tableau de bord, menu Clés API (voir Authentification), puis demandez à l'API qui vous êtes :
curl https://quietsocial.dev/api/v1/me \
-u "$QUIET_CLIENT_ID:$QUIET_CLIENT_SECRET"
La réponse dit sur quel espace de travail et sur quelle marque agit ce client, et quels périmètres il possède. C'est le premier appel de toute intégration : il évite de découvrir ses droits manquants un refus à la fois.
Parcours type
- Lister les destinations de la marque avec
GET /destinations, pour connaître leurs identifiants et ce que chacune accepte. - Envoyer l'image éventuelle avec
POST /media. - Créer la publication avec
POST /publications, en lui donnant une clé d'idempotence. - Être prévenu de l'issue, réseau par réseau, par un webhook — ou relire la publication avec
GET /publications/{id}.
Les pages de cette référence
- Authentification : identifiants, secret,
GET /me. - Périmètres : ce que chaque droit ouvre, et la marque d'un client.
- Idempotence : rejouer une écriture sans publier deux fois.
- Marques et destinations : où l'on peut publier, et quoi.
- Publications : créer, lire, libérer, annuler, relancer.
- Médias : envoyer et gérer les images.
- Webhooks : être notifié, et vérifier la signature.
- Erreurs : chaque code, et s'il faut réessayer.
- Limites et conventions : débit, pagination, identifiants.
- Serveur MCP : brancher un assistant sur l'API, avec la même clé.