O que é o Datalake
O Datalake é um conjunto de endpoints REST que exporta em massa os dados da sua área de trabalho na Coodesh para ferramentas de BI, data warehouse ou qualquer pipeline de dados interno.
Diferente dos endpoints operacionais da API, o Datalake foi desenhado para carga contínua: cada execução lê apenas o que mudou desde a última, o que permite manter uma cópia sincronizada dos dados sem reprocessar tudo a cada rodada.
Os dados são entregues em JSON, autenticados por chave de integração, na URL base https://api.coodesh.com/assessments/v2/datalake.
Documentação técnica
A referência completa dos endpoints, com parâmetros, campos de resposta, exemplos em Python e JavaScript e tabela de erros, está em:
Consulte essa página antes de iniciar a integração: ela é a fonte oficial do contrato de dados.
Quem pode solicitar acesso
O acesso ao Datalake é feito por meio de uma chave de integração da área de trabalho.
Na Coodesh, quem tem a permissão Gerenciar chaves de integração pode criar a chave em Área de Trabalho › Integrações. Perfis de Administrador e Gerente têm essa permissão por padrão; ela também pode ser concedida individualmente a uma pessoa em Pessoas › Permissões.
Ao criar a chave, selecione em Recursos acessíveis os escopos do grupo Datalake que a integração precisa. Se nenhum recurso for selecionado, a chave terá acesso completo à API — por segurança, prefira selecionar apenas o necessário.
A chave é exibida uma única vez. Copie e guarde em local seguro. Consulte Chaves de integração para o passo a passo.
Dois escopos não aparecem na tela de criação e precisam ser liberados pelo time da Coodesh mediante solicitação ao seu contato comercial ou ao suporte: eventos de integridade e imagens de proctoring. Isso ocorre porque envolvem evidências sensíveis de monitoramento.
Recursos disponíveis
Recurso | Uma linha por | Escopo necessário |
| tentativa de avaliação | Resultados de avaliações (datalake) |
| pessoa | Perfis e skills de usuários (datalake) |
| pessoa e habilidade | Perfis e skills de usuários (datalake) |
| mapa de habilidades respondido | Perfis e skills de usuários (datalake) |
| evento da linha do tempo de integridade | Eventos de integridade (sob solicitação) |
assessment_attempts traz nota, status, prazos, links de resultado, seções, distribuição de habilidades, carreira e o resumo de integridade da tentativa. integrity_events traz as evidências por trás desse resumo, um evento por linha.
Configurações disponíveis
Parâmetros de consulta
updated_since— data ISO 8601 (ex.:2026-01-01T00:00:00Z) que abre o fluxo a partir daquele ponto. Omita na primeira execução para exportar todo o histórico.limit— itens por página. Padrão 100, máximo 200. Valores acima disso são rejeitados, não truncados.cursor— posição opaca devolvida emnext_cursor. Use para avançar dentro da mesma execução. Não pode ser enviado junto comupdated_since.
Filtro por área de trabalho (subconta)
O cabeçalho x-subaccount-id restringe a exportação às avaliações de uma subconta específica. Disponível em assessment_attempts e integrity_events.
Imagens de proctoring
As imagens capturadas durante o monitoramento ficam atrás de um escopo próprio. Chaves sem esse escopo recebem ai_metadata (a leitura da imagem feita por IA), nunca a imagem. Quando liberada, a imagem chega em snapshot_url, um link temporário assinado com validade indicada em snapshot_expires_at — baixe o arquivo durante a ingestão, não armazene a URL como se fosse permanente.
Regras de consumo
A entrega é at-least-once: um registro alterado depois de já entregue volta a aparecer. Grave sempre por upsert usando o identificador do registro, nunca por inserção.
A resposta não traz totais. O campo
has_moreé o único sinal de parada.As páginas são sequenciais: cada requisição depende da resposta anterior, então a exportação é um laço, não requisições paralelas.
Guarde o maior
updated_atvisto na execução: é ele que abre a execução seguinte.
Perguntas frequentes
Preciso contratar algo à parte para usar o Datalake?
O Datalake faz parte da API da Coodesh. Fale com seu contato comercial para confirmar a disponibilidade no seu plano e para liberar os escopos de eventos de integridade e imagens de proctoring.
Com que frequência posso rodar a exportação?
Não há uma frequência obrigatória: você define o intervalo conforme a necessidade do seu pipeline. Como cada execução lê apenas o que mudou desde a anterior, uma sincronização diária costuma ser suficiente para a maioria dos casos.
Recomendamos agendar a exportação para horários de baixa demanda, preferencialmente no período noturno. Cargas completas ou de grande volume concorrem com o uso da plataforma pelas pessoas da sua equipe e pelos candidatos em avaliação; rodar fora do horário comercial reduz esse impacto e diminui a chance de você atingir o limite de requisições.
Existe um limite de requisições por segundo: ao receber o código 429, aguarde o tempo indicado no cabeçalho X-RateLimit-Reset e repita a chamada.
Perdi minha chave de integração. O que faço?
A chave não pode ser visualizada novamente. Apague a chave antiga e crie uma nova em Área de Trabalho › Integrações.
Os valores vêm traduzidos?
Campos de enumeração como event_type, severity e signal chegam sempre com o valor técnico, sem tradução, para que o data warehouse não precise tratar variações por idioma. Rótulos traduzidos, quando existem, vêm em campos separados com sufixo _formatted.