Relacionamentos - Promete

Endpoints de Relacionamento

Base path: /v1/relationships

Os endpoints abaixo representam a estrutura planejada. A implementação detalhada e a especificação OpenAPI serão geradas durante o desenvolvimento com FastAPI.

Pessoas

Método	Endpoint	Descrição
`GET`	`/v1/relationships/people`	Listar pessoas (paginado, com filtros)
`POST`	`/v1/relationships/people`	Criar nova pessoa
`GET`	`/v1/relationships/people/{id}`	Obter detalhes de uma pessoa
`PUT`	`/v1/relationships/people/{id}`	Atualizar dados de uma pessoa
`DELETE`	`/v1/relationships/people/{id}`	Remover uma pessoa
`GET`	`/v1/relationships/people/{id}/interactions`	Histórico de interações da pessoa
`GET`	`/v1/relationships/people/{id}/links`	Vínculos da pessoa no grafo

Organizações

Método	Endpoint	Descrição
`GET`	`/v1/relationships/organizations`	Listar organizações
`POST`	`/v1/relationships/organizations`	Criar nova organização
`GET`	`/v1/relationships/organizations/{id}`	Obter detalhes de uma organização
`PUT`	`/v1/relationships/organizations/{id}`	Atualizar organização
`DELETE`	`/v1/relationships/organizations/{id}`	Remover organização

Territórios

Método	Endpoint	Descrição
`GET`	`/v1/relationships/territories`	Listar territórios
`POST`	`/v1/relationships/territories`	Criar novo território
`GET`	`/v1/relationships/territories/{id}`	Obter detalhes de um território
`GET`	`/v1/relationships/territories/{id}/people`	Pessoas vinculadas ao território

Vínculos (Grafo)

Método	Endpoint	Descrição
`GET`	`/v1/relationships/links`	Listar vínculos
`POST`	`/v1/relationships/links`	Criar novo vínculo entre entidades
`DELETE`	`/v1/relationships/links/{id}`	Remover vínculo
`GET`	`/v1/relationships/graph/{entity_id}`	Obter grafo de vínculos de uma entidade

Segmentação

Método	Endpoint	Descrição
`GET`	`/v1/relationships/segments`	Listar segmentos
`POST`	`/v1/relationships/segments`	Criar segmento
`GET`	`/v1/relationships/segments/{id}/members`	Membros de um segmento
`GET`	`/v1/relationships/tags`	Listar tags
`POST`	`/v1/relationships/tags`	Criar tag

Erros e Códigos Comunicação