# Questions et réponses développeur

URL canonique : https://sosoapi.ai/fr/docs/developer-faq

Des réponses directes sur les alias npm, le choix entre API et MCP, l’authentification, les médias, les nouvelles tentatives sûres, les limites de débit et le sens exact de « publié ».

## Les quatre packages npm sont-ils des SDK différents ?

Non. Installez sosoapi ou un de ses alias : @sosoapi/cli, sosoapi-cli ou sosoapi-mcp. Chaque alias utilise exactement la même version de l’implémentation CLI et MCP. Un seul suffit.

- [Installation et packages](https://sosoapi.ai/fr/docs/installation)

## Faut-il utiliser HTTP, CLI ou MCP ?

Utilisez HTTP depuis votre serveur, la CLI pour automatiser dans le shell et examiner les schémas, ou MCP avec un agent compatible. Ils utilisent les mêmes contrats API publics. MCP propose aussi le téléversement local et un outil de publication par URL d’image qui prépare les médias pour vous. Gardez les identifiants serveur hors du code navigateur.

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

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

## La configuration ou le consentement OAuth publie-t-il quelque chose ?

Non. La configuration ne publie rien. Le consentement OAuth accorde un accès continu dans le périmètre choisi, sans nouvelle approbation dans le navigateur à chaque écriture. Dites à l’agent quand attendre une validation et vérifiez le compte, le contenu et l’heure avant de lui demander de publier.

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

## HTTP 200 ou 202 signifie-t-il publié ?

Non. La requête peut être acceptée, programmée ou encore en traitement. Enregistrez l’identifiant et lisez le même Scheduled Post jusqu’à confirmation de publication. Incluez le permalien s’il est disponible et indiquez le résultat de chaque destination séparément.

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

## Puis-je réessayer après une expiration ?

Vérifiez d’abord l’opération existante. Conservez l’identifiant Scheduled Post et réutilisez la même clé d’idempotence pour la même requête. Modifier le contenu crée une requête différente. Pour réessayer, modifier ou annuler une publication existante, utilisez sa version actuelle et une action proposée par SosoAPI pour cet état.

- [Gestion sûre des erreurs](https://sosoapi.ai/fr/docs/troubleshooting)

## Pourquoi manque-t-il un outil dans mon client ?

Vérifiez le profil, le type de connexion et le rechargement du serveur par le client. Core masque les outils d’administration ; HTTP n’inclut pas le téléversement local. La référence indique la disponibilité. Changer de profil ne change ni les autorisations ni l’éligibilité du compte.

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

## MCP distant peut-il téléverser un fichier local ?

Non. Utilisez MCP local pour téléverser depuis un dossier autorisé, ou importez une URL média publique sur HTTP. Vérifiez l’importation jusqu’à ce qu’elle soit prête, puis utilisez ensemble son identifiant enregistré et son URL canonique. Une importation acceptée reste en cours.

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

## Quelles sont les limites de débit et de forfait ?

Consultez chaque schéma pour les limites de champs, de listes et de pagination. studio-api autorise 240 requêtes par minute par utilisateur humain, avec un compartiment distinct de 480 par minute pour ses identifiants machine. Respectez 429 et Retry-After. Quotas de forfait, limites fournisseur et éligibilité sont distincts ; lisez les informations actuelles de facturation et de capacités avant une exécution importante.

- [Limites de l’API de publication](https://sosoapi.ai/fr/docs/publishing-api-reference)

## Où trouver Markdown et les schémas ?

Ajoutez .md à l’URL d’un guide, d’une opération API ou d’un outil MCP pour sa version Markdown. L’index API lie le contrat JSON public et le document OpenAPI 3.1. Commencez par llms.txt pour l’index ou llms-full.txt pour la référence complète dans les deux langues. Ces fichiers contiennent de la documentation publique, pas des données de compte ni des identifiants.

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

- [Index LLM](https://sosoapi.ai/fr/llms.txt)

## Ces documents garantissent-ils un référencement ou des citations IA ?

Non. Les pages HTML, URL canoniques, métadonnées structurées et Markdown aident les systèmes à lire la documentation. Les moteurs de recherche et services IA choisissent toujours ce qu’ils indexent, classent ou citent. Vérifiez ces résultats séparément de la disponibilité des pages.