Criar uma política
Endpoint POST /policies da API do Proteside: parâmetros, corpo da requisição, respostas e exemplos de código.
bearerAuthAutorizaçãoBearer <token>Token de API criado em Configurações → API. Os escopos ficam vinculados ao token; cada operação lista o escopo exigido em x-scope.
org_id?stringSomente parceiros (orgs:manage): atua sobre esta organização filha. Também pode ser enviado como org_id em corpos JSON.
uuidIdempotency-Key?stringReproduz a resposta original por 24 h
1 <= length <= 255application/json- body
name*string2 <= length <= 120description?stringlength <= 1000store_id?stringOmita para uma política no nível da organização
uuidmode?string"recommend""recommend""auto"priority?integer1 <= value <= 10000100match?conditions?action*string"authorize""needs_review""block"justification_template?stringlength <= 1000expires_days?|1 <= value <= 3650active?booleantruePolítica
application/json- response
id?stringuuidorg_id?stringuuidstore_id?|uuidname?stringdescription?string|nullversion?integeractive?booleanmode?string"recommend""auto"priority?integerMenor = avaliada primeiro; a primeira correspondência decide
match?conditions?action?string"authorize""needs_review""block"justification_template?|Aceita {domain} {vendor} {path}
expires_days?integer|nullis_default?booleancreated_at?stringdate-timeupdated_at?stringdate-timecurl -X POST "https://example.com/policies" \ -H "Content-Type: application/json" \ -d '{ "name": "Analytics approved by marketing", "match": { "origin": "known_vendor", "category": [ "analytics" ] }, "conditions": { "no_sensitive_field_access": true, "not_in_threat_list": true }, "action": "authorize", "mode": "recommend", "priority": 60, "justification_template": "{vendor} analytics ({domain}) — no access to payment fields in the last 30 days.", "expires_days": 90 }'{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "org_id": "a40f5d1f-d889-42e9-94ea-b9b33585fc6b", "store_id": "7fe87115-950c-4ae8-bd7e-970406bc9ac0", "name": "string", "description": "string", "version": 0, "active": true, "mode": "recommend", "priority": 0, "match": { "origin": "first_party", "domain": [ "string" ], "path_glob": [ "string" ], "category": [ "string" ], "vendor_id": [ "string" ] }, "conditions": { "same_origin": true, "prevalence_min": 0, "no_sensitive_field_access": true, "not_in_threat_list": true, "in_threat_list": true, "store_provider": true, "max_size_kb": 0, "has_integrity_attr": true }, "action": "authorize", "justification_template": "string", "expires_days": 0, "is_default": true, "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z"}Aplicar uma política aos scripts de uma loja POST
Endpoint POST /policies/{id}/apply da API do Proteside: parâmetros, corpo da requisição, respostas e exemplos de código.
Excluir uma política DELETE
Endpoint DELETE /policies/{id} da API do Proteside: parâmetros, corpo da requisição, respostas e exemplos de código.