Fetch a signed SMLTP compliance receipt
curl --request GET \
--url https://secureai.hiperai.ai/api/external/receipts/{bundleId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://secureai.hiperai.ai/api/external/receipts/{bundleId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://secureai.hiperai.ai/api/external/receipts/{bundleId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Segurança, Guardrails & Auditoria
Recibos Criptográficos SMLTP
Obtenha o recibo de conformidade SMLTP assinado para conclusão
GET
/
receipts
/
{bundleId}
Fetch a signed SMLTP compliance receipt
curl --request GET \
--url https://secureai.hiperai.ai/api/external/receipts/{bundleId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://secureai.hiperai.ai/api/external/receipts/{bundleId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://secureai.hiperai.ai/api/external/receipts/{bundleId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Recibos de Conformidade
Quando uma conclusão é roteada através do gateway SMLTP, a SecureAI produz um recibo de conformidade assinado — prova criptográfica da política que regeu a chamada. Este endpoint busca esse recibo por seu ID de pacote. Os recibos existem apenas para implantações roteadas por gateway. Em implantações de provedor direto, não há gateway para assinar recibos e esse endpoint retorna404.
Ponto final
GET /receipts/:bundleId
De onde vem o ID do pacote
As respostas de conclusão expõem o ID do pacote sempre que um direito SMLTP é criado para a chamada:- Endpoint clássico:
metadata.smltp.bundle_id(e ummetadata.smltp.receipt_urlpronto). - Endpoint compatível com OpenAI:
secureai.smltp_bundle_id.
jti-…) é retornado mesmo em implantações de provedor nativo/direto. O recibo assinado nesse ID, no entanto, só existe quando o tráfego é roteado através do gateway SMLTP — em implantações diretas, esse endpoint retorna 404 (veja abaixo).
Autenticação
Authorization: Bearer sk-your-api-key-here
Exemplo de solicitação
curl -X GET "https://{customer.name}.hiperai.ai/api/external/receipts/bnd_9f2c...e71" \
-H "Authorization: Bearer sk-your-api-key-here"
Resposta
200 OK
{
"success": true,
"receipt": {
"bundle_id": "bnd_9f2c...e71",
"...": "signed SMLTP receipt payload (policy, entitlement, verdict, signatures)"
}
}
receipt é a carga assinada emitida pelo gateway. Consulte SMLTP Segurança para saber como os recibos se enquadram no modelo de transparência e auditoria.
404 não encontrado
{
"success": false,
"error": "Receipt not found",
"message": "No receipt for this bundle id. Receipts are only available when requests are routed through the SMLTP gateway, and are retained in its in-memory store for a limited time. The authoritative record is the hash-chained audit log."
}
400 Solicitação incorreta
Retornado quando o ID do pacote está ausente ou tem mais de 128 caracteres.Notas
- Os recibos são mantidos no armazenamento na memória do gateway por tempo limitado. Para provas de longo prazo, confie no log de auditoria encadeado por hash — o registro oficial e imutável. Veja Logs Imutáveis.
- Nem toda implantação passa pelo gateway; trate um
404como “sem recebimento de gateway para esta chamada”, e não como um erro em sua integração.