Skip to main content

​
O que são serviços marketplace?

Serviços marketplace (integration_type = service) são produtos do catálogo que expõem endpoints HTTP dedicados no contexto da sua organização. Diferente de enrichments (que enriquecem o perfil da entidade), serviços respondem consultas pontuais invocadas pela sua integração. O Gu1 atua como proxy multi-tenant: você autentica com a mesma API key ou sessão do restante da plataforma; o Gu1 resolve organizationId, verifica se o produto está ativo para a org, aplica billing quando configurado e devolve um envelope JSON normalizado.

​
Path base

Todos os serviços compartilham este prefixo: 
GET https://api.gu1.ai/api/integration-services/{integrationCode}/...
Substitua {integrationCode} pelo código de catálogo (por exemplo ar_gueno_holder_intelligence_service).

​
Autenticação

Igual ao restante da API Gu1: 
Authorization: Bearer YOUR_API_KEY
Chamadas via dashboard com sessão também são suportadas para a console; integradores normalmente usam API keys.

​
Ativação

A organização deve habilitar a integração no Marketplace (mesmo fluxo de enrichments e listas).

​
Envelope de resposta

Sucesso: 
{
  "success": true,
  "data": { }
}
Erro: 
{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Mensagem legível"
  }
}

​
Cobrança

  • Endpoints gratuitos (health, exists) não consomem pack nem créditos.
  • Endpoints cobráveis cobram uma unidade por request bem-sucedido quando base_price_cents > 0.

​
Auditoria

Cada chamada é registrada para a org. O CUIT do path nunca é persistido em texto claro na auditoria.

​
Motor de regras

Vários serviços expõem campos em services.{serviceKey}.* em Condições de regras.

​
Serviços disponíveis

Inteligência de Titulares CBU/CVU

Totais CBU/CVU por CUIT (Argentina), janelas contratuais e métricas incrementais custom (Com. A 8298 BCRA).

​
Documentação relacionada