Ingerir consumo de sistema de IA de terceiro
Recebe assentos e consumo de um ativo em lote, numa única transação. Reenviar o mesmo lote não duplica: a resposta separa received de created, e é essa diferença que evidencia a idempotência. Um lote pode declarar replace_period para afirmar que é o relato completo do que cobre; nesse caso batch_id é obrigatório, porque é ele que identifica a rodada e impede a substituição de apagar o que a própria rodada acabou de gravar. Além do escopo, exige da identidade da chave a permissão third_party_usage_manage: o consumo por assento é dado individual de cada pessoa. Exige o escopo governance:write.
Authorization
chaveDeApi Chave de API da organização, criada nas configurações. Envie-a em Authorization: Bearer <sua chave>.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/governance/usage" \ -H "Content-Type: application/json" \ -d '{}'{ "ok": true, "asset_id": "string", "seats": { "received": 0, "created": 0 }, "usage": { "received": 0, "created": 0, "replaced": 0 }, "unmatched_seats": [ { "seat_id": "string", "external_user_key": "string", "email": "string" } ], "unmatched_count": 0}Remover um webhook
Remove o webhook. O endereço para de receber eventos imediatamente. Exige o escopo governance:write.
Ler consumo de sistema de IA de terceiro
Consumo agregado do período, por assento (group_by=seat) ou pelo total do ativo (group_by=asset). No total do ativo, o rateio não atribuído vem em coluna separada: somado ao consumo por assento, viraria consumo de gente. A janela é obrigatória e não tem default: uma janela implícita faria a mesma chamada devolver números diferentes conforme o dia. Além do escopo, exige da identidade da chave a permissão third_party_usage_view. Exige o escopo governance:read.