# Preguntas y respuestas para desarrolladores URL canónica: https://sosoapi.ai/es/docs/developer-faq Respuestas directas sobre alias npm, elección de API y MCP, autenticación, archivos multimedia, reintentos seguros, límites de frecuencia y qué significa realmente publicado. ## ¿Los cuatro paquetes npm son SDK diferentes? No. Instala sosoapi o uno de sus alias: @sosoapi/cli, sosoapi-cli o sosoapi-mcp. Cada alias usa la misma versión exacta de la implementación de CLI y MCP. Solo necesitas uno. - [Instalación y paquetes](https://sosoapi.ai/es/docs/installation) ## ¿Debo usar HTTP, CLI o MCP? Usa HTTP desde tu servidor, CLI para automatización de shell y consulta de esquemas, o MCP con un agente compatible. Todos usan los mismos contratos públicos de API. MCP también ofrece carga de archivos locales y una herramienta de publicación de imágenes por URL que prepara los archivos multimedia por ti. Mantén las credenciales del servidor fuera del código del navegador. - [Referencia completa de API](https://sosoapi.ai/es/docs/api) - [Referencia de herramientas MCP](https://sosoapi.ai/es/docs/mcp) ## ¿La configuración o el consentimiento OAuth publica algo? No. La configuración no publica nada. El consentimiento OAuth concede acceso continuo dentro del alcance elegido, sin nueva aprobación en el navegador para cada escritura. Indica al agente cuándo debe esperar revisión y comprueba la cuenta, el contenido y la hora antes de pedirle publicar. - [Autenticación y permisos](https://sosoapi.ai/es/docs/authentication) ## ¿HTTP 200 o 202 significa que ya se publicó? No. La solicitud puede estar aceptada, programada o todavía procesándose. Guarda el ID y consulta la misma publicación programada hasta que su resultado confirme la publicación. Incluye el enlace permanente cuando esté disponible e informa del resultado de cada destino por separado. - [Resultados de publicación](https://sosoapi.ai/es/docs/publishing-api-reference) ## ¿Puedo reintentar tras agotar el tiempo de espera? Comprueba primero la operación existente. Conserva el ID de publicación programada y reutiliza la misma clave de idempotencia para la misma solicitud. Si cambias el payload, es otra solicitud. Para reintentar, actualizar o cancelar una publicación existente, usa su versión actual y una acción que SosoAPI ofrezca para ese estado. - [Gestión segura de errores](https://sosoapi.ai/es/docs/troubleshooting) ## ¿Por qué falta una herramienta en mi cliente? Comprueba el perfil, el tipo de conexión y si el cliente ha recargado el servidor. core oculta herramientas de administración; las conexiones HTTP no incluyen carga de archivos locales. La referencia de herramientas indica la disponibilidad. Cambiar de perfil no cambia permisos ni elegibilidad de cuentas. - [Referencia de herramientas MCP](https://sosoapi.ai/es/docs/mcp) ## ¿Puede MCP remoto cargar un archivo local? No. Usa MCP local para cargar un archivo de una carpeta permitida o importa una URL multimedia pública por HTTP. Comprueba la importación hasta que esté lista y usa juntos el ID de recurso registrado y su URL canónica. Una importación aceptada sigue en curso. - [Referencia de herramientas MCP](https://sosoapi.ai/es/docs/mcp) ## ¿Cuáles son los límites de frecuencia y del plan? Consulta en cada esquema los límites de campos, listas y paginación. studio-api admite 240 solicitudes por minuto y usuario para sesiones humanas, con un cupo independiente de 480 por minuto para las credenciales de máquina de ese usuario. Respeta 429 y Retry-After. Las cuotas del plan, los límites del proveedor y la elegibilidad de la cuenta son independientes; consulta la información actual de facturación y capacidades antes de una ejecución grande. - [Límites de la API de publicación](https://sosoapi.ai/es/docs/publishing-api-reference) ## ¿Dónde están Markdown y los esquemas? Añade .md a la URL de una guía, operación API o herramienta MCP para su versión Markdown. El índice API enlaza el contrato JSON público y el documento OpenAPI 3.1. Empieza en llms.txt para un índice de páginas o llms-full.txt para la referencia completa en ambos idiomas. Estos archivos contienen documentación pública, no datos de cuenta ni credenciales. - [Referencia completa de API](https://sosoapi.ai/es/docs/api) - [Índice LLM](https://sosoapi.ai/es/llms.txt) ## ¿Esta documentación garantiza apariciones en búsquedas o citas de IA? No. Las páginas HTML, URL canónicas, metadatos estructurados y Markdown ayudan a los sistemas a leer la documentación. Los buscadores y servicios de IA siguen eligiendo qué indexar, posicionar o citar. Comprueba esos resultados por separado de la disponibilidad de las páginas.