SUMÁRIO
-
Visão Geral
-
API de Autenticação
-
API de Refresh Token (opcional)
-
APIs de Callback
-
Autenticação nos Callbacks
-
Entrega da Documentação
AGRO ANALYTICS E INFRAESTRUTURA
Monitoramento de Incêndio
Alertas antecipados e rotas otimizadas por meio de câmeras e satélites em áreas de risco.
Nossas soluções para o agro
Autenticação dos Callbacks
5 - Resumo de Erros e Troubleshooting (FAQ)
"
1- Visão Geral
1- Visão Geral
A integração com a Cyan exige que a empresa parceira implemente:
-
Uma API de autenticação compatível com o padrão JWT.
-
Endpoints de callback para receber os dados de relatórios (validações, itens, uso do solo, análise de risco).
-
Envio da documentação completa dessas APIs à equipe da Cyan.
Os dados de relatório são processados de forma assíncrona e particionada por talhão, por isso a estrutura de callbacks é obrigatória.
2 - API Autenticação
Requisitos para a API de autenticação:
-
A autenticação deve ser feita via POST com username e password no corpo da requisição, seguindo o modelo abaixo:
Body esperado (JSON):
{
"username": "MyUserName",
"password": "cyfrinair123"
}
Regras obrigatórias:
-
Os campos username e password são obrigatórios.
-
Os nomes dos atributos devem ser exatamente esses: username, password.
Resposta esperada:
A resposta da API pode ter dois formatos válidos:
1. Apenas o token como string:
eyJraWQiOiJLR2p6Z1ZKUXRidGVx…
2. Objeto JSON com tokens:
{
"accessToken": "eyJhbGciOiJIUzI1NiIs...",
"idToken": "eyJhbGciOiJIUzI1NiIsIn...",
"refreshToken": "eyJhbGciOiJIUzI1NiIs..."
}
Regras obrigatórias:
-
accessToken é obrigatório.
-
idToken é opcional (necessário apenas se os callbacks exigirem esse valor).
-
refreshToken é opcional, mas se for utilizado, deve ter validade mínima de 30 dias.
-
Os tokens devem seguir a especificação JWT.
-
O accessToken e o idToken devem ter o mesmo tempo de expiração.
-
Não é necessário retornar os atributos mfaRequired e session, pois não são utilizados na integração com os callbacks.
3 - API de Refresh Token (opcional)
Se desejar oferecer renovação automática de tokens, implemente também um endpoint de refresh:
Body esperado (JSON):
{
"refreshToken": "eyJhbGciOiJIUzI1NiIs..."
}
Resposta esperada:
{
"accessToken": "NOVO_ACCESS_TOKEN",
"idToken": "NOVO_ID_TOKEN (opcional)"
}
Regras obrigatórias:
-
O accessToken deve ser retornado obrigatoriamente.
-
O idToken só deve ser retornado se os callbacks exigirem esse token.
-
O tempo de expiração do idToken deve ser igual ao do accessToken.
4 - APIs de Callback
A empresa parceira deve disponibilizar os seguintes endpoints para receber dados assíncronos dos relatórios de seguro:
Callback de Validações
-
Recebe os resultados de validações (ex: socioambientais).
-
Os dados são enviados de forma particionada e assíncrona, por talhão.
-
A especificação da estrutura dos payloads será fornecida via Swagger.
-
FAQ - Callback de Validações
Callback de Itens
-
Recebe os dados de itens analisados no relatório.
-
Envio particionado e assíncrono, conforme as análises são concluídas.
-
Detalhes no Swagger de referência.
-
FAQ - Callback de Itens
Callback de Uso do Solo (landUse)
-
Recebe a parte do relatório referente aos produtos (uso do solo) de cada talhão.
-
Os dados são enviados todos de uma vez, não de forma particionada.
-
FAQ - Callback de Uso do Solo
Callback de Análise de Risco
-
Recebe a análise de risco do relatório.
-
Envio único e estruturado conforme especificação da Cyan.
-
FAQ - Callback de Análise de Risco
5 - Autenticação nos Callbacks
Header de autorização
As requisições feitas pela Cyan aos endpoints de callback incluirão o accessToken no header. A API de callback deve aceitar um dos seguintes formatos:
-
Formato 1 (token direto):
Authorization: eyJraWQiOiJLR2p6Z1ZKUX...
-
Formato 2 (prefixo Bearer):
Authorization: Bearer eyJraWQiOiJLR2p6Z1ZKUX...
Caso sua API aceite apenas um dos formatos, informe previamente à equipe da Cyan.
6 - Entrega da Documentação
A documentação das APIs de autenticação e de callback deve ser compartilhada com a equipe da Cyan. Essa documentação deve conter:
-
Endpoints com métodos (ex: POST /callback/validation)
-
Exemplo de payloads de entrada e saída
-
Regras de autenticação e tempos de expiração
-
Definição do formato do header de autorização esperado
1 - Como acessar o Portal do Suporte
Resposta: Você pode acessar o Portal do Suporte clicando aqui. Ou se preferir, pode acessar o Portal quando logado no dashboard Cyan, clicando no ícone de engrenagem (configurações) no canto inferior da barra lateral, e em seguida, em “Suporte” e “Portal de Suporte”.
2 - Como relatar um problema ou BUG?
Resposta: No Portal do Suporte, clique em “Relatar um problema”. É importante descrever com clareza sobre o problema que está enfrentando. A equipe de suporte receberá seu chamado e responderá o mais rápido possível.
3 - Como solicitar suporte técnico?
Resposta: No Portal do Suporte, clique em “Suporte Técnico”. Informe sua unidade e descreva o contexto da solicitação. Este chamado pode ser usado para solicitação de implementações, como códigos de caminhões, nomes no relatório de incêndio, e até mesmo integrações.
Para problemas mais específicos, selecione a opção “Outras questões”, ou sugira melhorias, clicando em “Sugerir melhoria”.
4 - Níveis de prioridade
Resposta: Ao criar um ticket, o usuário deve selecionar o nível de prioridade da solicitação, de acordo com a urgência e impacto da demanda. A equipe de T.I realizará uma análise criteriosa, em colaboração com a equipe de Produto, para validar a prioridade informada. Caso a prioridade selecionada pelo usuário não esteja condizente com o impacto real da solicitação, o tempo de resolução esperado pode ser diferente. Os níveis de prioridade, tempos estimados de resolução e exemplos de situações são descritos abaixo:
Tempo máximo para a primeira resposta: 2 horas (horário comercial)
-
Muito Alto (Highest)
-
A solicitação é extremamente urgente e crítica, necessitando atenção imediata, pois está causando ou pode causar interrupções significativas em serviços essenciais.
-
Tempo para resolução: Até 5 horas (horário comercial).
-
-
Alto (High)
-
A solicitação é importante e deve ser tratada com prioridade, mas não compromete imediatamente as operações críticas da equipe de T.I.
-
Tempo para resolução: De 1 a 2 dias (horário comercial).
-
-
Médio (Medium)
-
A solicitação é de impacto moderado e não necessita de uma resposta imediata. Pode ser atendida sem comprometer o fluxo de trabalho.
-
Tempo para resolução: De 3 a 7 dias (horário comercial).
-
-
Baixo (Low)
-
A solicitação é de baixa prioridade, com impacto pequeno ou nulo no dia a dia da usabilidade.
-
Tempo para resolução: De 10 a 30 dias (horário comercial).
-
-
Muito Baixo (Lowest)
-
A solicitação é de prioridade mínima, geralmente de impacto insignificante ou que pode ser atendida em janelas específicas de menor atividade.
-
Tempo para resolução: Até 60 dias (horário comercial).
-
5 - Diferenças entre problemas internos do Cyan e problemas de máquina/rede do usuário
Resposta: Aqui estão algumas maneiras de diferenciar entre problemas internos do site e questões relacionadas à máquina ou rede do usuário.
Problemas Internos do Site:
-
Os problemas internos do site geralmente afetam todos os usuários, não apenas um.
-
Mensagens de erro específicas do site, como "Solicitação Incorreta" ou "Erro 404", indicam que o problema está do lado do Cyan.
-
Se outros sites estão funcionando corretamente e apenas um está apresentando problemas, é provável que o problema seja interno ao site do Cyan.
-
Falta de dados (como áreas da unidade em branco nos mapas do Cyan ou gráficos em branco).
Problemas de Máquina ou Rede do Usuário:
-
Se o problema ocorre em um único dispositivo, é mais provável que seja um problema local.
-
Problemas de conexão com a internet, como uma rede lenta ou intermitente, podem ser indicativos de problemas na rede do usuário.
-
Mensagens de erro genéricas, como "Sem conexão com a internet" ou "Página não pode ser exibida", geralmente apontam para problemas do lado do usuário.
-
Páginas do Cyan com erros de carregamento.
-
Falha ao reproduzir vídeos (como o de imagens de satélite no módulo de ‘Previsão’) no dashboard.
Para identificar a origem do problema, o usuário pode tentar acessar o site de diferentes dispositivos ou redes. Se o problema persistir em todos os dispositivos ou redes, é mais provável que seja um problema interno do site. Se o problema ocorrer apenas em um dispositivo ou rede específica, é provável que seja um problema local. É importante contatar a equipe de T.I da usina para validar erros internos e resolvê-los. Se após essa validação, for constatado que o erro é do Cyan, é recomendado abrir um ticket pelo Portal do Suporte.
6 - Horário do Suporte e contatos
-
Suporte Comercial: segunda a domingo, em horário comercial.
-
Suporte de TI: segunda a sexta, em horário comercial.
Quem Somos
Perguntas Frequentes
@2026 CYAN ANALYTICS
Rua República do Iraque, 40, conj. 309 - Jardim Oswald Cruz
São José dos Campos - SP
CEP: 12216-540
Avenida Luiz Eduardo Toledo Prado – Vila do Golfe
Torre Empresarial II, nº 870 – Salas 308/309
Ribeirão Preto - SP
CEP: 14.027-250
Atendimento
De segunda a sexta das 8h às 17h
Sábados das 9h às 14h
+55 11 94168-8856
+55 11 3842-9444
+55 11 5583-0652
Portal do Suporte
Quem Somos
Suporte e Ajuda
Perguntas Frequentes
Portal do Suporte
Quer uma solução completa para uma gestão mais eficiente?
Preencha o formulário para que um especialista da Cyan entre em contato com você.