Pular para o conteúdo principal

Início | API AutoDriveDDF da Dadosfera

1 · URL base do seu Autodrive​

Cada workspace do Autodrive é executado em seu próprio host dedicado.

https://<workspace-slug>.autodrive.dadosfera.ai

Substitua <workspace-slug> pelo slug recebido quando sua instância do Autodrive foi provisionada.
Todos os caminhos de endpoints nesta referência são relativos a essa URL base.


2 · Autenticação​

O Autodrive usa autenticação HTTP Basic.

CampoValor
UsuárioSeu login de administrador/usuário da Dadosfera
SenhaSua senha ou token da Dadosfera

Informe essas credenciais na aba Auth → Basic do seu cliente REST (Postman, Insomnia etc.).
O cliente gerará o cabeçalho Authorization: Basic … automaticamente.


3 · Fluxo típico (ordem cronológica)​

  1. Enviar arquivos
    POST /upload → retorna dataset_id

  2. Fazer uma pergunta

    • Apenas trechos de documentos: POST /dataset/{dataset_id}/question
    • Resposta gerada por IA: POST /dataset/{dataset_id}/ai_question
  3. Obter o resultado
    GET /dataset/{dataset_id}/question/{question_id}
    ou
    GET /dataset/{dataset_id}/ai_question/{question_id}


TarefaEndpoint
Criar um dataset (enviar arquivos)POST /upload
Listar datasets existentesGET /datasets
Consultar status do datasetGET /dataset/{dataset_id}
Adicionar mais documentosPUT /dataset/{dataset_id}
Fazer pergunta (trechos)POST /dataset/{dataset_id}/question
Fazer pergunta (resposta de IA)POST /dataset/{dataset_id}/ai_question
Obter trechosGET /dataset/{dataset_id}/question/{question_id}
Obter resposta de IAGET /dataset/{dataset_id}/ai_question/{question_id}
Verificar disponibilidade do serviçoGET /health

5 · Próximos passos​

  1. Copie a URL base do workspace.
  2. Autentique-se com Basic Auth no seu cliente REST.
  3. Siga o Fluxo típico acima ou acesse um endpoint na barra lateral para consultar os detalhes completos de requisição e resposta.

Boas consultas!