Proteside Docs
Referencia de endpointsInformes PCI

Informe PCI de un período (JSON, PDF o CSV)

GET
/reports/pci

Reutiliza el snapshot más reciente del mismo período exacto; de lo contrario, genera un snapshot on_demand. format=pdf responde 302 Location: <signed URL, 1 h> (o los bytes del PDF cuando el archivo aún no está en el storage); format=csv transmite la tabla elegida. regenerate=true fuerza un nuevo snapshot y requiere reports:generate. Las organizaciones que no son socias necesitan un plan con informes de cumplimiento (403 plan_limit).

Autorización

bearerAuth
headerAutorizaciónBearer <token>

Token de API creado en Ajustes → API. Los alcances están vinculados al token; cada operación indica el alcance requerido en x-scope.

Parámetros de consulta

org_id?string

Solo socios (orgs:manage): actúa sobre esta organización hija. También se puede enviar como org_id en cuerpos JSON.

Formatouuid
store_id*string
Formatouuid
period_start?string

Por defecto: period_end − 7 días

Formatodate-time
period_end?string

Por defecto: ahora. Rango máximo de 366 días.

Formatodate-time
format?string
Predeterminado"json"
Valor en"json""pdf""csv"
csv_table?string
Predeterminado"scripts"
Valor en"scripts""headers""alerts"
locale?string
Predeterminado"pt-BR"
Valor en"pt-BR""en"
regenerate?boolean
Predeterminadofalse

Cuerpo de la respuesta

Snapshot (json) o CSV

  1. response
id?string
Formatouuid
store_id?string
Formatouuid
kind?string
Valor en"weekly""on_demand""monthly"
period_start?string
Formatodate-time
period_end?string
Formatodate-time
locale?string
Valor en"pt-BR""en"
schema_version?integer
sha256?string|null
generated_by?string
has_pdf?boolean
csv_tables?array<string>
created_at?string
Formatodate-time
generated?boolean

true when this request generated the snapshot

data?

Report data schema_version 2: meta, scope, summary_643, summary_1161, scripts[], headers[], alerts[], policies[], periodic_checks[], data_access[]

curl -X GET "https://example.com/reports/pci?store_id=497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "id": "f1a2b3c4-9999-4000-8111-222233334444",  "store_id": "0c1d2e3f-1111-4222-8333-444455556666",  "kind": "on_demand",  "period_start": "2026-09-20T10:00:00.000Z",  "period_end": "2026-09-27T10:00:00.000Z",  "locale": "pt-BR",  "schema_version": 2,  "sha256": "9c1e…",  "generated_by": "api:ps_live_AbCdEfGhIjKlMnOpQrStUvWx",  "has_pdf": true,  "csv_tables": [    "scripts",    "headers",    "alerts"  ],  "created_at": "2026-09-27T10:12:00.000Z",  "generated": true,  "data": {    "meta": {      "report_id": "f1a2b3c4-…",      "store": "Loja do João",      "domain": "lojadojoao.com.br",      "schema_version": 2    },    "summary_643": {      "total": 21,      "authorized": 18,      "blocked": 1,      "needs_review": 2,      "expired": 0    },    "summary_1161": {      "events": 91234,      "alerts_total": 12,      "alerts_open": 1    },    "scripts": [],    "headers": [],    "alerts": [],    "policies": [],    "periodic_checks": [],    "data_access": []  }}