Aller au contenu

Canaux

Ce que l’application appelle un canal, l’API l’appelle une integration : un compte social connecté. Son id est ce que toutes les autres routes prennent comme integrationId ou integration.

GET /integrations vos canaux
GET /social/{integration} commencer à en connecter un (URL OAuth)
GET /is-connected vérifier la clé API
GET /integration-settings/{id} règles, longueur maximale, schéma des réglages, outils
POST /integration-trigger/{id} lancer un outil du fournisseur
GET /find-slot/{id} prochain créneau libre du canal
GET /integrations/{id}/posting-times créneaux du canal
PUT /integrations/{id}/posting-times remplacer les créneaux du canal
GET /workspaces vos workspaces et leurs canaux
GET /groups alias déprécié de /workspaces
DELETE /integrations/{id} déconnecter
GET /integrations
Paramètre Obligatoire Description
workspace Non Seulement les canaux de ce workspace (un id renvoyé par GET /workspaces)
group Non Déprécié : même effet que workspace

Réponse 200 :

[
{
"id": "cm4ean69r0003w8w1cdomox9n",
"name": "maltaexpat",
"identifier": "instagram-standalone",
"picture": "https://media.usenadia.com/avatar.jpg",
"disabled": false,
"profile": "maltaexpat",
"workspace": { "id": "cm9w0rk5p0001w8w1a2b3c4d5", "name": "Malta Expat" },
"customer": { "id": "cm9w0rk5p0001w8w1a2b3c4d5", "name": "Malta Expat" }
}
]
Champ Type Description
id string L’id du canal
name string Tel qu’affiché dans l’application
identifier string La plateforme : instagram-standalone, tiktok, x, linkedin, youtube ou threads
picture string | null URL de l’avatar
disabled boolean Déconnecté, ou au-delà de l’offre
profile string | null Le nom d’utilisateur sur la plateforme
workspace object Le workspace du canal (chaque canal en a exactement un) : id, name
customer object Déprécié : même valeur que workspace, gardé pour les SDK publiés
GET /social/{integration}

Renvoie l’URL OAuth vers laquelle envoyer la personne. Connecter se passe dans le navigateur : la personne autorise l’accès sur la plateforme, qui la renvoie vers UseNadia, et le canal apparaît dans la liste ci-dessus.

Paramètre Où Obligatoire Description
integration chemin Oui instagram-standalone, tiktok, x, linkedin, youtube ou threads
refresh requête Non L’id d’un canal existant : le parcours renouvelle son jeton au lieu de créer un canal

Réponse 200 :

{ "url": "https://www.instagram.com/oauth/authorize?client_id=…&state=…" }

L’état derrière l’URL vit une heure. 400 quand l’identifiant est inconnu (Integration not allowed) ; 500 quand l’URL de la plateforme n’a pas pu être générée, ce qui arrive pour une plateforme enregistrée qui n’a pas d’identifiants ici.

GET /is-connected

Répond { "connected": true } avec une clé valide, 401 sans. Utile pour tester rapidement une configuration ; la session MCP et la CLI le font pour vous.

GET /integration-settings/{id}

Réponse 200 :

{
"output": {
"rules": "Instagram should have at least one attachment, if it's a story, it can have only one picture",
"maxLength": 2200,
"settings": { "type": "object", "properties": { "post_type": { … } } },
"tools": []
}
}
Champ Description
rules Les règles de publication de la plateforme, en une phrase
maxLength Caractères autorisés dans le texte, compte vérifié pris en compte
settings Le schéma JSON des réglages du fournisseur, ou la chaîne No additional settings required quand la plateforme n’en a pas
tools Les outils du fournisseur que POST /integration-trigger/{id} peut lancer : methodName, description, dataSchema (key, type, description)

404 quand le canal n’est pas le vôtre.

POST /integration-trigger/{id}
{ "methodName": "audioSearch", "data": { "q": "summer" } }

Lance un outil que le fournisseur expose et répond 201 avec { "output": … }, la réponse brute du fournisseur. 404 quand le canal n’est pas le vôtre ou que l’outil n’existe pas sur sa plateforme (Tool not found) ; 401 quand le jeton de la plateforme a expiré et n’a pas pu être renouvelé, auquel cas le canal est déconnecté.

GET /find-slot/{id}

Parcourt les créneaux du canal à partir de maintenant, jour par jour, en ne gardant que ceux qui servent ce jour de la semaine, et répond le premier sans publication planifiée, 200 :

{ "date": "2026-10-21T10:00:00.000Z" }

400 si le canal n’a aucun créneau (ou aucun jour coché).

GET /integrations/{id}/posting-times
PUT /integrations/{id}/posting-times

Un créneau est une heure et les jours où il sert, en UTC : time en minutes après minuit UTC (0 à 1439, 18 h 30 UTC = 1110), days de 0 (dimanche) à 6 (samedi), sans days = tous les jours. GET répond, et PUT prend dans le corps { "times": [...] } puis répond, 200 :

{
"integrationId": "cm4ean69r0003w8w1cdomox9n",
"times": [
{ "time": 480, "days": [1, 3, 5] },
{ "time": 1110 }
]
}

PUT remplace tous les créneaux du canal ; les publications déjà planifiées ne bougent pas. 404 sur un canal qui n’est pas à vous.

GET /workspaces

Répond 200 avec vos workspaces, du plus ancien au plus récent. Un workspace est un dossier de canaux : chaque canal est dans exactement un workspace, et toute organisation en a au moins un (voir Workspaces et périmètre).

[
{
"id": "cm9w0rk5p0001w8w1a2b3c4d5",
"name": "Malta Expat",
"channels": ["cm4ean69r0003w8w1cdomox9n"],
"type": "BUSINESS",
"logo": "https://uploads.usenadia.com/2026/10/28/logo.png",
"website": "https://maltaexpat.com",
"country": "MT",
"timezone": "Europe/Malta",
"about": "Guides for expats moving to Malta. Friendly, practical tone."
}
]
Champ Type Description
id string L’id du workspace, ce que prennent GET /integrations?workspace= et GET /posts?workspace=
name string Tel qu’affiché dans l’application
channels string[] Les ids des canaux du workspace
type string PERSONAL, BUSINESS ou CLIENT
logo string | null L’URL du logo ; null sans logo, ou quand son média a été supprimé de la bibliothèque
website string | null Le site de la marque
country string | null Le pays de l’audience, ISO 3166-1 alpha-2 (MT)
timezone string | null Le fuseau du workspace, IANA (Europe/Malta)
about string | null Marque, audience, ton : le contexte qu’un agent lit avant d’écrire pour ce workspace

Un champ que personne n’a rempli vaut null. Créer, renommer ou supprimer un workspace, remplir son contexte et y déplacer un canal se fait depuis l’application (Paramètres → Workspaces).

DELETE /integrations/{id}

Supprime le canal et toutes les publications planifiées dessus. Réponse 200 : la ligne du canal. 404 quand il n’est pas le vôtre, ou qu’il est déjà supprimé.