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.
| Campo | Valor |
|---|---|
| Usuário | Seu login de administrador/usuário da Dadosfera |
| Senha | Sua 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)
-
Enviar arquivos
POST /upload→ retornadataset_id -
Fazer uma pergunta
- Apenas trechos de documentos:
POST /dataset/{dataset_id}/question - Resposta gerada por IA:
POST /dataset/{dataset_id}/ai_question
- Apenas trechos de documentos:
-
Obter o resultado
GET /dataset/{dataset_id}/question/{question_id}
ou
GET /dataset/{dataset_id}/ai_question/{question_id}
4 · Links rápidos para endpoints
| Tarefa | Endpoint |
|---|---|
| Criar um dataset (enviar arquivos) | POST /upload |
| Listar datasets existentes | GET /datasets |
| Consultar status do dataset | GET /dataset/{dataset_id} |
| Adicionar mais documentos | PUT /dataset/{dataset_id} |
| Fazer pergunta (trechos) | POST /dataset/{dataset_id}/question |
| Fazer pergunta (resposta de IA) | POST /dataset/{dataset_id}/ai_question |
| Obter trechos | GET /dataset/{dataset_id}/question/{question_id} |
| Obter resposta de IA | GET /dataset/{dataset_id}/ai_question/{question_id} |
| Verificar disponibilidade do serviço | GET /health |
5 · Próximos passos
- Copie a URL base do workspace.
- Autentique-se com Basic Auth no seu cliente REST.
- 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!