Pular para o conteúdo principal

Datasets

Tabelas de dados customizadas da empresa (schema próprio por dataset) e suas linhas.

Rotas​

método e rotao que faz
GET /v1/api/datasetsListar tabelas de dados (API)
GET /v1/api/datasets/{datasetId}Detalhar tabela de dados / schema (API)
GET /v1/api/datasets/{datasetId}/rowsListar linhas da tabela (API)
POST /v1/api/datasets/{datasetId}/rowsAdicionar linha na tabela (API)
DELETE /v1/api/datasets/{datasetId}/rowsExcluir linhas da tabela (API)
PATCH /v1/api/datasets/{datasetId}/rows/{rowId}Editar linha da tabela (API)

Detalhar um dataset​

curl 'https://api.dynadok.com/v1/api/datasets/6500a1b2c3d4e5f600000005' \
  --header 'x-api-key: 550e8400-e29b-41d4-a716-446655440000.SUA_CHAVE'
{
  "code": 200,
  "message": "OK",
  "timestamp": 1758585600000,
  "data": {
    "_id": "6500a1b2c3d4e5f600000005",
    "name": "Funcionários ativos",
    "columns": [],
    "rowCount": 128,
    "structured": true,
    "createdAt": "2026-09-23T12:00:00.000Z",
    "updatedAt": "2026-09-23T12:00:00.000Z"
  }
}

Cada item de columns tem name, type, key e options — o schema publicado não lista os valores possíveis de type, então confira a resposta real do seu dataset em vez de assumir um valor. GET /v1/api/datasets devolve a mesma forma, paginada, em data como array.

Linhas do dataset​

GET .../rows pagina as linhas (page, perPage, máx. 200), com filtro por filters (JSON), query e ordenação por orderByColumn/orderByDirection. POST .../rows cria uma linha a partir de { "data": { ... } }, com as chaves de data batendo com as columns do dataset. DELETE .../rows recebe { "ids": [...] } e exclui em lote. PATCH .../rows/{rowId} atualiza uma linha, também via { "data": { ... } }.

O schema publicado não declara o formato de data na resposta dessas quatro rotas — o conteúdo depende inteiramente das colunas do dataset. Formato completo na Referência.

Erros típicos​

Ver Envelope e erros. datasetId ou rowId inexistente responde 404.