Documentação para desenvolvedores
Perguntas e respostas para desenvolvedores
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.
Ler como MarkdownRevisado pela equipe SosoAPI ·
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.