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

Pré-requisitos: Assinatura Pro e chave API válida necessárias para todos os endpoints.

Autenticação

Todas as solicitações da API requerem autenticação usando sua chave API no cabeçalho Authorization:

Authorization: SUA_CHAVE_API

URL Base

https://telesto.app/v2

Limites de Taxa

  • 100 solicitações por hora por endereço IP
  • Timeout de 15 minutos se o limite de taxa for excedido
  • Todas as solicitações devem incluir a chave API no cabeçalho Authorization

Exceder o limite de taxa resultará em um bloqueio temporário de 15 minutos para seu endereço IP.

Formato de Resposta

Todas as respostas são retornadas em formato JSON. Campos vazios ou nulos são retornados como strings vazias para consistência.

Resposta de Sucesso

{
    "id": "abc123...",
    "name": "Meu Produto",
    "created": "2024-01-15 10:30:00"
}

Resposta de Erro

{
    "statusCode": 401,
    "error": {
        "type": "UNAUTHORIZED",
        "description": "Chave API inválida"
    }
}

Códigos de Erro

Código Tipo Descrição
401 UNAUTHORIZED Chave API ausente ou inválida
403 FORBIDDEN Assinatura Pro necessária
404 NOT_FOUND Recurso não encontrado
429 TOO_MANY_REQUESTS Limite de taxa excedido (aguarde 15 min)
500 SERVER_ERROR Erro interno, tente novamente mais tarde

Exemplo Rápido

Solicitação

curl -X GET "https://telesto.app/v2/products" 
  -H "Authorization: SUA_CHAVE_API"

Resposta

[
    {
        "id": "a1b2c3...",
        "name": "Widget",
        "ean_upc": "123456789",
        "stock_onhand": "50",
        "created": "2024-01-15 10:30:00"
    }
]

Melhores Práticas

  • Armazene sua chave API de forma segura (nunca em código do lado do cliente)
  • Implemente lógica de retry para respostas 429 (limite de taxa)
  • Faça cache das respostas quando possível para reduzir chamadas da API
  • Use HTTPS para todas as solicitações

Dica: Teste sua integração em pequenos lotes primeiro para garantir que permaneça dentro dos limites de taxa.

Documentação Completa

A documentação completa da API com parâmetros detalhados e exemplos está disponível em:

https://documenter.getpostman.com/view/3493/2s93Y2R1a8

Primeiros Passos

  1. Certifique-se de ter uma assinatura Pro
  2. Entre em contato com o suporte para solicitar acesso à API e obter sua chave
  3. Revise a documentação para endpoints disponíveis

Atualmente em Beta: Estamos expandindo ativamente os endpoints e funcionalidades da API. Se você tem interesse em usar a API ou precisa de endpoints específicos, entre em contato com nossa equipe de suporte.