Integre os dados do EV Manual nos seus dispositivos de diagnóstico, sistemas de gestão de oficina ou plataformas de comércio eletrónico. Os serviços para parceiros estão disponíveis em três formas — escolha a que se adequa ao seu produto:
| Forma | Ideal para | Como funciona |
|---|---|---|
| Incorporação de widget JS | Sites, portais de concessionário | Duas linhas de JavaScript incorporam o descodificador VIN e a pesquisa de manuais em qualquer página; as sessões e a faturação são tratadas por nós. |
| API REST | Ferramentas de diagnóstico, sistemas de gestão | Endpoints HTTPS JSON com assinatura HMAC de pedido; faturação por uso, limites ajustados ao seu volume. |
| CNAME de marca branca | Grupos de concessionários, plataformas | O centro técnico de dados completo funciona sob o seu próprio subdomínio (p. ex. dados.asuamarca.pt) com o seu logótipo e cores. |
A API expõe quatro domínios de dados — descodificação VIN, fichas técnicas, manuais de oficina e diagramas de cablagem com pesquisa DTC — e cada resposta inclui os mesmos metadados de nível de correspondência que a interface web. Quem integra pode, assim, apresentar a informação de confiança aos utilizadores finais sem lógica adicional.
| Domínio | Conteúdo |
|---|---|
| Descodificação VIN | VIN de 17 dígitos → fabricante, série, versão de modelo, motor/motor elétrico, transmissão, chassis; níveis de prefixo exato e recurso WMI. |
| Fichas técnicas | Parâmetros de fábrica completos por versão de modelo — dimensões, pesos, motor, bateria, pneus, capacidades. |
| Manuais de oficina | Manuais de oficina específicos por modelo — índice e esquema pesquisáveis antes de desbloquear o documento completo. |
| Diagramas e DTC | Diagramas de circuito com sobreposição de componentes e definição/causas/sugestões do código de avaria. |
Cada pedido é autenticado com um par de chaves API e uma assinatura HMAC-SHA256 que cobre o timestamp e o corpo do pedido, o que evita ataques de repetição e usos não autorizados. A faturação é por uso: as chamadas são medidas e deduzidas do seu saldo de tokens, e os patamares de volume baixam automaticamente o preço unitário à medida que o uso cresce.
Uma integração típica demora de um a cinco dias úteis: registe uma conta gratuita, peça credenciais de teste a partir da página de parceria e chame o endpoint sandbox com um VIN conhecido para verificar o fluxo de assinatura. Por exemplo, descodificar o VIN de uma Toyota Camry de 2019 devolve a versão do modelo, o seu prefixo VIN de 8 caracteres e uma ligação para a ficha técnica numa única resposta JSON.
timestamp + method + path + body; é fornecido um
assinalizador de referência em Python e JavaScript.A maioria dos parceiros valida a integração com três VIN de referência — uma correspondência de prefixo exato, um recurso WMI e um candidato ao nível da marca — porque esses três casos exercitam todos os caminhos de código que o descodificador pode tomar.
As integrações atuais incluem um fabricante europeu de ferramentas de diagnóstico que descodifica VIN antes de escanear, um marketplace de peças que associa os anúncios às versões de modelo e um grupo de concessionários que opera o centro de dados completo sob um CNAME de marca branca. Em cada caso, a superfície de integração é idêntica — apenas o perfil de faturação difere. A atualidade dos dados coincide com o site público, porque as respostas da API são servidas do mesmo conjunto de dados atualizado em 2026-10-15.
Toda a integração começa numa sandbox gratuita que espelha a forma dos dados de produção mas responde com um conjunto fixo de VIN de referência — constrói e testa, portanto, sem gastar um único token. Além disso, a sandbox devolve os mesmos metadados de nível de correspondência que a produção, o que significa que a sua lógica de exibição da confiança é testada com casos reais de recurso antes do lançamento.