# Perguntas e respostas para desenvolvedores URL canônica: https://sosoapi.ai/pt-br/docs/developer-faq Respostas diretas sobre aliases npm, escolha entre API e MCP, autenticação, mídia, repetições seguras, limites de taxa e o que publicado realmente significa. ## Os quatro pacotes npm são SDKs diferentes? Não. Instale sosoapi ou um de seus aliases: @sosoapi/cli, sosoapi-cli ou sosoapi-mcp. Cada alias usa a mesma versão exata da implementação da CLI e do MCP. Você só precisa de um. - [Instalação e pacotes](https://sosoapi.ai/pt-br/docs/installation) ## Devo usar HTTP, CLI ou MCP? Use HTTP no servidor, a CLI para automação de shell e consulta de schemas ou MCP com um agente compatível. Todos usam os mesmos contratos públicos de API. O MCP também oferece envio de arquivos locais e uma ferramenta de publicação por URL de imagem que prepara a mídia para você. Mantenha credenciais de servidor fora do código do navegador. - [Referência completa da API](https://sosoapi.ai/pt-br/docs/api) - [Referência de ferramentas MCP](https://sosoapi.ai/pt-br/docs/mcp) ## A configuração ou o consentimento OAuth publica um post? Não. A configuração não publica nada. O consentimento OAuth concede acesso contínuo no escopo escolhido, sem nova aprovação no navegador para cada gravação. Diga ao agente quando aguardar revisão e confira conta, conteúdo e horário antes de pedir uma publicação. - [Autenticação e permissões](https://sosoapi.ai/pt-br/docs/authentication) ## HTTP 200 ou 202 significa publicado? Não. A requisição pode estar aceita, agendada ou ainda processando. Salve o ID do post e consulte o mesmo Scheduled Post até seu resultado confirmar a publicação. Inclua o permalink quando disponível e informe o resultado de cada destino separadamente. - [Resultados de publicação](https://sosoapi.ai/pt-br/docs/publishing-api-reference) ## Posso tentar novamente após um timeout? Confira primeiro a operação existente. Mantenha o ID do Scheduled Post e reutilize a mesma chave de idempotência para a mesma requisição. Se mudar o payload, será uma requisição diferente. Para repetir, atualizar ou cancelar um post existente, use sua versão atual e uma ação oferecida pelo SosoAPI para esse estado. - [Tratamento seguro de erros](https://sosoapi.ai/pt-br/docs/troubleshooting) ## Por que uma ferramenta está ausente no meu cliente? Confira o perfil, o tipo de conexão e se o cliente recarregou o servidor. Core oculta ferramentas de administração; conexões HTTP não incluem envio de arquivos locais. A referência de ferramentas lista a disponibilidade. Alterar o perfil não muda as permissões nem a elegibilidade da conta. - [Referência de ferramentas MCP](https://sosoapi.ai/pt-br/docs/mcp) ## O MCP remoto pode enviar um arquivo local? Não. Use MCP local para enviar um arquivo de uma pasta permitida ou importe uma URL pública de mídia por HTTP. Confira a importação até ficar pronta e use seu ID de ativo registrado junto à URL canônica. Uma importação aceita ainda está em andamento. - [Referência de ferramentas MCP](https://sosoapi.ai/pt-br/docs/mcp) ## Quais são os limites de taxa e do plano? Confira os limites de campos, listas e paginação em cada schema. studio-api permite 240 requisições por minuto por usuário em sessões humanas, com um bucket separado de 480 por minuto para as credenciais de máquina desse usuário. Respeite 429 e Retry-After. Cotas do plano, limites do provedor e elegibilidade da conta são separados; consulte as informações atuais de cobrança e capacidades antes de uma execução grande. - [Limites da API de publicação](https://sosoapi.ai/pt-br/docs/publishing-api-reference) ## Onde estão Markdown e schemas? Adicione .md à URL de um guia, operação de API ou ferramenta MCP para acessar a versão Markdown. O índice da API vincula o contrato JSON público e o documento OpenAPI 3.1. Comece por llms.txt para um índice de páginas ou llms-full.txt para a referência completa nos dois idiomas. Esses arquivos contêm documentação pública, não dados de contas nem credenciais. - [Referência completa da API](https://sosoapi.ai/pt-br/docs/api) - [Índice LLM](https://sosoapi.ai/pt-br/llms.txt) ## Estes documentos garantem resultados de busca ou citações por IA? Não. Páginas HTML, URLs canônicas, metadados estruturados e Markdown ajudam os sistemas a ler a documentação. Os mecanismos de busca e serviços de IA ainda escolhem o que indexar, classificar ou citar. Verifique esses resultados separadamente da disponibilidade das páginas.