Descobre como dois objetos se conectam
Descobre cadeias entre dois objetos; use `traverseObjectPath` quando a cadeia já for conhecida. Agrupa resultados por cadeia, traz intermediários em `examples` e conta sequências distintas em `path_count`, sem duplicar fontes. Cadeias curtas vêm primeiro. O padrão é dois saltos; o terceiro é mais caro.
In: header
Query Parameters
Objeto de origem (pub_…).
Objeto de destino (pub_…).
Comprimento máximo da cadeia (1–3, default 2). O terceiro salto custa segundos.
21 <= value <= 3Cadeias distintas a devolver (1–25, default 10).
101 <= value <= 25Aplica a data a cada salto. Sem ela, a ligação pode ser histórica. Relações static são excluídas de buscas passadas e informadas em meta.excluded_shapes. Corte temporal (AAAA-MM-DD). Sem at, usa o acervo histórico. Conforme o shape de listObjectRelations, event acumula até a data, snapshot escolhe o retrato aplicável e static pode ser recusada por não afirmar vigência passada.
^\d{4}-\d{2}-\d{2}$Como interpretar o id: auto segue fusões e, em cisões, responde 409 com os sucessores; exact lê literalmente o objeto desse id. Use exact para acessar o ramo de uma cisão que preservou o identificador original ou para desativar o redirecionamento automático.
"auto""auto" | "exact"Response Body
curl -X GET "https://api.databolsa.com/v1/objects/paths?from_id=string&to_id=string&max_hops=2&limit=10&at=string&resolve=auto"{
"data": [
{
"hops": 0,
"chain": "string",
"path_count": 0,
"paths": 0,
"examples": [
"string"
]
}
],
"meta": {
"at": "string",
"as_of": "string",
"as_of_by_rel": {
"property1": "string",
"property2": "string"
},
"excluded_shapes": [
"event"
]
}
}{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string",
"details": {
"property1": null,
"property2": null
}
}Agrega uma coorte por propriedade ou relação
Agrega a mesma coorte de `rankObjects`, recortada por `kind`, `subkind`, relações e `where`. `group_by` aceita propriedade ou relação; `meta.group_by_kind` identifica o caso e grupos relacionais trazem `entity_id`. Use `group_by_direction` para indicar onde a coorte está na aresta. `sum` é recusado para percentual, razão, múltiplo e ponto de índice; `avg`, `median`, `min` e `max` preservam a unidade. Sem `fact`, `agg=count` conta objetos. `cohort_objects`, `cohort_with_value`, `ungrouped` e `multi_group` mostram cobertura e sobreposição; ausência de valor produz `null`, nunca zero. Leia o total da coorte em `meta.cohort_value`, não somando a página. `cursor` pagina os grupos, `q` filtra seus rótulos e `order_by` escolhe ordenar pelo valor ou pelo número de objetos.
Obtém um objeto e suas relações disponíveis
Retorna a identidade, os identificadores em `keys` e um resumo das relações em `links`. IDs com um sucessor são redirecionados e preenchem `redirected_from`; uma cisão responde 409 com os sucessores. Use `resolve=exact` para ler literalmente um ramo que preservou o ID antigo.