Skip to main content
POST
/
integration-execution
/
execute-without-entity
Executar enriquecimento marketplace sem entidade
curl --request POST \
  --url http://api.gu1.ai/integration-execution/execute-without-entity \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "integrationCode": "<string>",
  "country": "<string>",
  "type": "<string>",
  "taxId": "<string>",
  "name": "<string>",
  "parameters": {}
}
'
{
  "result": {}
}
Rota sob /integration-execution. Usa os mesmos códigos de integração do Marketplace (veja Códigos de provedores).
Exige permissão para executar enriquecimentos (mesma família que POST /integration-execution/marketplace/enrichment).
Execuções headless não criam nem atualizam entities, normalized_enrichment nem auditoria vinculada a entidade. Apenas gravam auditoria append-only (headless_enrichment_execution_audit) e, quando aplicável, cache (headless_enrichment_cache) em sucessos.

​
Visão geral

Use para rodar um enriquecimento com taxId e/ou nome, país e tipo (person / company) sem cadastrar antes uma pessoa ou empresa na Gu1. Endpoints relacionados (somente leitura): Listar execuções headless e Detalhe por id.

​
URL

POST https://api.gu1.ai/integration-execution/execute-without-entity

​
Query

​
cached
boolean
default:"false"
Se true ou 1, retorna apenas payload em cache de sucesso anterior (mesma org, integração, país, tipo, tax/nome, hash de parâmetros). Sem chamada ao provedor nem tokens. Sem cache → 404 (CACHE_MISS).

​
Corpo (JSON)

​
integrationCode
string
required
Código de integração do Marketplace.
​
country
string
required
País ISO-3166-1 alpha-2.
​
type
string
required
person ou company.
​
taxId
string
Opcional. Exige pelo menos taxId ou name.
​
name
string
Opcional.
​
parameters
object
Opcional; padrão {}.

​
Resposta 200 (enriquecimento com sucesso)

Quando enrichmentSuccess é true, o corpo inclui entre outros:
​
result
object
Objeto com raw e mapped: cada um é um objeto indexado pelo código de integração (mesma família que enriquecimentos marketplace em entidade).
Também: success, cached, integrationCode, country, type, enrichmentSuccess, errors, totalCostCents, executionTimeMs, probeEntityId, billing (na resposta HTTP só tokensSpent e balanceRemainingCents; o custo em centavos do intento está em totalCostCents e na auditoria, não dentro de billing).

​
Erros comuns

400 sem provedor para o contexto; 422 falha do provedor ou normalização; 403 integração desabilitada; 404 CACHE_MISS com cached=true; 402 saldo insuficiente.

​
Exemplo

curl -sS -X POST 'https://api.gu1.ai/integration-execution/execute-without-entity' \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "integrationCode": "br_bdc_basic_data_enrichment",
    "country": "BR",
    "type": "person",
    "taxId": "12345678909",
    "parameters": {}
  }'