Referência da API

Alvos

Um alvo é uma única URL sendo monitorada. Criar um agenda automaticamente um pulse; a primeira verificação é capturada pelo agendador.

O campo type controla a estratégia de busca e é um dentre page, page_list, search_results, feed, profile ou api_endpoint. Se omitido, o Gabinete360 infere um padrão sensato a partir da URL e do tipo do projeto.

GET/v1/targets

Listar alvos

Retorna os alvos de um determinado projeto. O parâmetro de query projectId é obrigatório.

Parâmetro	Tipo	Descrição
`projectId`obrigatórioquery	uuid	O projeto cujos alvos devem ser retornados.

Requisição

curl "https://gabinete360.ia.br/api/v1/targets?projectId=8f3c1a2b-…" \
  -H "Authorization: Bearer argos_ak_live_••••••"

Resposta

200 OK

[
  {
    "id": "a17d…",
    "projectId": "8f3c1a2b-…",
    "url": "https://example.com/pricing",
    "label": "Acme pricing page",
    "type": "page",
    "isActive": true,
    "lastCheckedAt": null,
    "createdAt": "2026-05-24T18:25:03.000Z"
  }
]

POST/v1/targets

Criar um alvo

Registra uma nova URL para monitorar. Um pulse é criado usando o padrão do tipo de projeto, a menos que intervalMinutes seja fornecido. Retorna 402 se a cota de alvos for excedida.

Parâmetro	Tipo	Descrição
`projectId`obrigatóriobody	uuid	O projeto a que este alvo pertence.
`url`obrigatóriobody	string (uri)	A URL a monitorar. Deve ser uma URL válida e parseável.
`label`opcionalbody	string \| null	Nome legível por humanos para o alvo.
`type`opcionalbody	TargetType	Sobrescreve a estratégia de busca inferida.
`intervalMinutes`opcionalbody	integer (≥ 1)	Sobrescreve o intervalo de pulse padrão do tipo de projeto.
`extractorConfig`opcionalbody	object \| null	Dicas de extrator (seletores CSS, caminhos JSON). O schema varia por tipo.
`importanceFilterConfig`opcionalbody	object \| null	Regras que decidem quais deltas viram eventos. O schema varia por tipo.

Requisição

curl -X POST https://gabinete360.ia.br/api/v1/targets \
  -H "Authorization: Bearer argos_ak_live_••••••" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "8f3c1a2b-…",
    "url": "https://example.com/pricing",
    "label": "Acme pricing page",
    "intervalMinutes": 60
  }'

Resposta

200 OK

{
  "id": "a17d…",
  "projectId": "8f3c1a2b-…",
  "url": "https://example.com/pricing",
  "label": "Acme pricing page",
  "type": "page",
  "isActive": true,
  "lastCheckedAt": null,
  "createdAt": "2026-05-24T18:25:03.000Z"
}

PATCH/v1/targets/{id}

Pausar ou retomar um alvo

Alterna se um alvo é verificado ativamente. Envie isActive: false para pausar, true para retomar.

Parâmetro	Tipo	Descrição
`id`obrigatóriopath	uuid	O ID do alvo.
`isActive`obrigatóriobody	boolean	Se o alvo deve ser verificado no seu pulse.

Requisição

cURL

curl -X PATCH https://gabinete360.ia.br/api/v1/targets/a17d… \
  -H "Authorization: Bearer argos_ak_live_••••••" \
  -H "Content-Type: application/json" \
  -d '{"isActive": false}'

Resposta

200 OK

{ "success": true }

DELETE/v1/targets/{id}

Excluir um alvo

Remove permanentemente um alvo e para de verificá-lo.

Parâmetro	Tipo	Descrição
`id`obrigatóriopath	uuid	O ID do alvo.

Requisição

cURL

curl -X DELETE https://gabinete360.ia.br/api/v1/targets/a17d… \
  -H "Authorization: Bearer argos_ak_live_••••••"

Resposta

200 OK

{ "success": true }