Perguntas frequentes
Qual é a diferença entre /auth/token e /oauth2/token?
Nenhuma. Os dois caminhos recebem o mesmo formulário e devolvem a mesma resposta. Use o que preferir.
Devo usar login local ou token OAuth?
Para integrações sistema a sistema, use o password grant: ele devolve um token Bearer no JSON. O login local reproduz o login do usuário, com MFA, e entrega a sessão em cookie.
Por quanto tempo o token é válido?
Pelo número de segundos informado em expires_in. O valor depende da configuração do ambiente.
O campo scope indica as permissões do token?
Não. scope contém a URI da API configurada no ambiente. As permissões são definidas pelas regras do usuário no ambiente.
A API aceita JSON no corpo das requisições?
Não. Os endpoints recebem application/x-www-form-urlencoded, multipart/form-data ou application/octet-stream. As respostas são JSON, exceto nos downloads.
Posso montar a URL de download a partir do id do arquivo?
Não. Use sempre o linkURL devolvido pela listagem. Ele contém parâmetros assinados que autorizam o download.
O destinatário de um link compartilhado precisa de usuário e senha?
Não. O link seguro autoriza o download; o destinatário pode precisar apenas do PIN. Veja Links compartilhados.
Como verifico se o arquivo chegou íntegro?
Informe o hash no envio (campo h ou header X-STCPDIRECTLINK-HASH) e compare o length da resposta com o tamanho do arquivo. Veja Enviar arquivos.
Onde encontro a especificação OpenAPI?
Em Especificação OpenAPI, em português, inglês e espanhol.