# Dépanner les connexions API, CLI et MCP

URL canonique : https://sosoapi.ai/fr/docs/troubleshooting

Résolvez les échecs de connexion, d’autorisation, de schéma, de téléversement et d’écriture incertaine sans exposer d’identifiants ni dupliquer un travail accepté.

## Mauvais navigateur ou connexion locale bloquée

Arrêtez la connexion en attente, puis exécutez auth login --no-open. Ouvrez la nouvelle URL affichée dans le profil navigateur souhaité. Vérifiez le compte et l’espace avant d’accorder l’accès et utilisez un seul profil pour ce lien. Si le port 8789 est occupé, identifiez le processus à l’écoute et ne l’arrêtez que s’il s’agit d’une connexion lancée par vous.

```
npx sosoapi auth login --no-open
```

```
lsof -nP -iTCP:8789 -sTCP:LISTEN
```

## 401, 403 et comptes indisponibles

Pour 401, vérifiez votre connexion et la validité de l’identifiant. Pour 403, vérifiez le rôle, le périmètre choisi et la capacité requise. Utilisez auth status et vérifiez l’e-mail du compte et le type d’identifiant accepté. Ne modifiez l’accès que si l’opération le nécessite ; changer de profil d’outils n’accorde aucune autorisation.

Vérifiez le compte social séparément. Lisez sa connexion et ses capacités, et reconnectez-le uniquement si le fournisseur demande un nouveau consentement. Une erreur de service interne ne justifie pas de recréer une connexion saine.

- [Authentification et autorisations](https://sosoapi.ai/fr/docs/authentication)

- [Référence API complète](https://sosoapi.ai/fr/docs/api)

## Validation 400 et décalage de version

Lisez le corps de réponse et les chemins des champs de validation. Les erreurs de validation peuvent contenir un ZodError ; les gestionnaires peuvent utiliser error, message et code. Comparez la requête au contrat installé et mettez à jour le package client si nécessaire. Corrigez les champs nommés sans supprimer de valeurs requises ni ajouter de filtres non pris en charge.

```
npx sosoapi api contract --route /studio-api/scheduled-posts/
```

## 409, 429, 5xx ou écriture expirée

Pour 409, lisez la dernière version et les actions disponibles avant de modifier. Pour 429, attendez selon Retry-After et réduisez la concurrence. Si une écriture expire ou renvoie 5xx, gardez son identifiant et vérifiez d’abord le résultat existant : le serveur a pu l’accepter avant la rupture de connexion.

Réessayez uniquement si l’opération et son état actuel le permettent. Gardez la même clé pour le même contenu et ne créez pas de remplacement pour contourner un résultat incertain. Corrigez les échecs d’authentification avant de réessayer. Le statut d’une tâche encore en attente peut déjà contenir une erreur d’exécution utile.

- [Référence de publication](https://sosoapi.ai/fr/docs/publishing-api-reference)

## Problèmes de téléversement ou de découverte d’outils

Le téléversement local accepte les médias pris en charge jusqu’à 500 MiB depuis le répertoire de travail, le dossier temporaire, Pictures/Movies/Videos ou les dossiers de SOSOAPI_UPLOAD_ROOTS. Les dossiers cachés et liens symboliques sortant de ces racines sont refusés. Ajoutez le dossier média précis, pas tout votre répertoire personnel. Une connexion HTTP ne peut pas lire les fichiers locaux.

Si des outils manquent, reconnectez le client et comparez son profil et son type de connexion à la référence. Vérifiez leur chargement dans la conversation actuelle ; un nom de serveur enregistré ne le confirme pas à lui seul.

- [Référence des outils MCP](https://sosoapi.ai/fr/docs/mcp)

## Partager des diagnostics utiles en sécurité

Partagez le nom de l’opération, l’heure, le statut HTTP, le code d’erreur sans donnée sensible et request_id ou x-request-id si disponible. Incluez la version CLI et le type MCP local ou distant. Retirez jetons, cookies, liens d’autorisation, URL médias signées, contenus clients et identifiants privés. Partagez l’erreur pertinente plutôt qu’un fichier d’identifiants ou une réponse entière.

- [Contacter SosoAPI](https://sosoapi.ai/fr/contact)