Gerenciamento de Datasets
Listar Datasets
Gerenciamento de Datasets
Listar Datasets
Endpoint para listar todos os datasets de um host específico.
Este endpoint retorna informações sobre os datasets de um host específico.
Endpoint
POST /api/externalAPIs/public/tolkyReasoning/datasetsListHelper
Parâmetros
| Parâmetro | Tipo | Descrição |
|---|---|---|
hostId | string (UUID) | UUID do host (obrigatório) |
avatarIds | array de string (UUID) | Lista de UUIDs dos avatares |
Exemplo de Requisição
curl -X POST \
'{BASE_URL}/api/externalAPIs/public/tolkyReasoning/datasetsListHelper' \
-H 'Content-Type: application/json' \
-d '{
"hostId": "uuid-do-host",
"avatarIds": ["uuid-do-avatar-1", "uuid-do-avatar-2"]
}'
Exemplo de Resposta
{
"code": 200,
"message": "Success",
"data": [
{
"id": "uuid-do-dataset",
"dataset_name": "Nome do Dataset",
"dataset_type": "Tipo do Dataset",
"created_at": "2025-05-12T01:39:34.904317+00:00",
"updated_at": "2025-05-12T01:39:34.904317+00:00"
}
]
}
Funcionamento
A rota datasetsListHelper busca todos os datasets associados ao host especificado. Opcionalmente, você pode filtrar os resultados por avatares específicos fornecendo uma lista de IDs de avatares.
A requisição tem um timeout de 60 segundos para garantir uma resposta em tempo hábil.
Códigos de Erro
400: Campos obrigatórios ausentes ou inválidos403: Credenciais inválidas ou sem permissão de acesso408: A requisição excedeu o limite de tempo de 60 segundos500: Erro interno do servidor ao processar a requisição