API do Telesto

Integre o Telesto com as suas próprias soluções internas ou com serviços de terceiros usando a nossa API RESTful. Perfeito para integrações personalizadas e fluxos de trabalho automatizados.

Pré-requisitos: É necessária uma subscrição Pro e uma chave de API válida para todos os endpoints.

O Que Pode Fazer

• Produtos crie, consulte, atualize e elimine o seu catálogo
• Stock por armazém veja exatamente onde está o stock de cada produto, e não apenas o total da conta
• Transações movimente stock para dentro e para fora, e consulte o registo completo para reconciliar com o seu próprio sistema
• Categorias, posições de armazenamento e fornecedores criação, consulta, atualização e eliminação completas

Referência da API

A referência completa documenta cada endpoint, parâmetro e resposta, com exemplos de código prontos a usar em curl, PHP, Python, Node e Ruby. Também pode enviar pedidos reais para a sua própria conta diretamente a partir da página.

Autenticação

Envie a sua chave de API no cabeçalho Authorization em cada pedido. Envie a chave em bruto, sem o prefixo Bearer:

Limites de Taxa

100 pedidos por hora, contados por chave de API. Ultrapassar este limite bloqueia-o durante 15 minutos, e a resposta indica-lhe quanto tempo deve aguardar. Os pedidos que falham na autenticação são contabilizados pelo seu endereço IP, por isso uma chave incorreta nunca consome a sua quota.

Boas Práticas

• Guarde a sua chave de API de forma segura, nunca em código do lado do cliente
• Obtenha páginas grandes em vez de fazer muitos pedidos pequenos, e coloque em cache tudo o que não muda com frequência
• Respeite o cabeçalho Retry-After em vez de repetir imediatamente um pedido que atingiu o limite de taxa
• Ao atualizar um registo, envie apenas os campos que pretende alterar. Tudo o que deixar de fora mantém o valor atual
• Se uma transação de stock exceder o tempo limite, verifique a lista de transações antes de a enviar novamente. Repetir às cegas pode movimentar o mesmo stock duas vezes

Primeiros passos

1. Confirme que tem uma subscrição Pro
2. Contacte o suporte para solicitar acesso à API e obter a sua chave
3. Abra a referência da API e experimente fazer um pedido diretamente a partir da página

Atualmente em Beta: Estamos a expandir ativamente os endpoints e as funcionalidades da API. Se tiver interesse em utilizar a API ou precisar de endpoints específicos, contacte a nossa equipa de suporte.