Справочник API

Политики

Политики решений: черновики, проверка, публикация, версии и различия.

Список политик

GET/v1/policies

Области доступа
policies:read

Параметры

ПолеТипОбязательно
cursorзапросstringнет
limitзапросintegerнет

Ответы

  • 200PolicyList
  • 400
  • 401
  • 403
  • 404
  • 409
  • 412
  • 413
  • 415
  • 422
  • 428
  • 429
  • 503

Создать политику

POST/v1/policies

Области доступа
policies:write
Обязательный заголовок
Idempotency-Key

Тело запросаPolicyCreate

ПолеТипОбязательно
namestringда
purposestringда
country_codesarray of stringда
required_checksemail_signal is a low-assurance signal and is not allowed here. pep_screening and adverse_media_screening are optional checks only.array of enum: document_ocr, document_authenticity, document_presence, document_status, face_match, face_pad, capture_integrity, nfc_integrity, ...да
optional_checksemail_signal is allowed only here; its fail and inconclusive do not block approval. pep_screening and adverse_media_screening are allowed only here: provider unavailability does not block approval, an unresolved potential match does until it is resolved.array of enum: document_ocr, document_authenticity, document_presence, document_status, face_match, face_pad, capture_integrity, nfc_integrity, ...нет
legal_profile_idstring (uuid)да
retention_profile_idstring (uuid)да
ruleset_idstring (uuid)да
screening_profile_idstring (uuid)нет
calibration_profile_idsarray of string (uuid)да
allow_manual_reviewbooleanда
allow_reusebooleanда
kyb_profileKybProfileнет
previous_version_idPolicy version this version derives from (same tenant). Versions linked this way form one lineage.string (uuid)нет
require_second_reviewApprove and reject resolutions of manual review need an approval of another identity (ReviewResolve.approval_id).booleanнет

Ответы

  • 201Policy
  • 400
  • 401
  • 403
  • 404
  • 409
  • 412
  • 413
  • 415
  • 422
  • 428
  • 429
  • 503

Получить политику

GET/v1/policies/{policy_id}

Области доступа
policies:read

Параметры

ПолеТипОбязательно
policy_idпутьstring (uuid)да

Ответы

  • 200Policy
  • 400
  • 401
  • 403
  • 404
  • 409
  • 412
  • 413
  • 415
  • 422
  • 428
  • 429
  • 503

Изменить черновик политики

PUT/v1/policies/{policy_id}

Области доступа
policies:write
Обязательный заголовок
If-Match

Параметры

ПолеТипОбязательно
policy_idпутьstring (uuid)да

Тело запросаPolicyCreate

ПолеТипОбязательно
namestringда
purposestringда
country_codesarray of stringда
required_checksemail_signal is a low-assurance signal and is not allowed here. pep_screening and adverse_media_screening are optional checks only.array of enum: document_ocr, document_authenticity, document_presence, document_status, face_match, face_pad, capture_integrity, nfc_integrity, ...да
optional_checksemail_signal is allowed only here; its fail and inconclusive do not block approval. pep_screening and adverse_media_screening are allowed only here: provider unavailability does not block approval, an unresolved potential match does until it is resolved.array of enum: document_ocr, document_authenticity, document_presence, document_status, face_match, face_pad, capture_integrity, nfc_integrity, ...нет
legal_profile_idstring (uuid)да
retention_profile_idstring (uuid)да
ruleset_idstring (uuid)да
screening_profile_idstring (uuid)нет
calibration_profile_idsarray of string (uuid)да
allow_manual_reviewbooleanда
allow_reusebooleanда
kyb_profileKybProfileнет
previous_version_idPolicy version this version derives from (same tenant). Versions linked this way form one lineage.string (uuid)нет
require_second_reviewApprove and reject resolutions of manual review need an approval of another identity (ReviewResolve.approval_id).booleanнет

Ответы

  • 200Policy
  • 400
  • 401
  • 403
  • 404
  • 409
  • 412
  • 413
  • 415
  • 422
  • 428
  • 429
  • 503

Проверить политику

POST/v1/policies/{policy_id}/validate

Области доступа
policies:write
Обязательный заголовок
Idempotency-Key
Обязательный заголовок
If-Match

Параметры

ПолеТипОбязательно
policy_idпутьstring (uuid)да

Ответы

  • 200ValidationResult
  • 400
  • 401
  • 403
  • 404
  • 409
  • 412
  • 413
  • 415
  • 422
  • 428
  • 429
  • 503

Опубликовать политику

POST/v1/policies/{policy_id}/publish

Области доступа
policies:publish
Обязательный заголовок
Idempotency-Key
Обязательный заголовок
If-Match

Параметры

ПолеТипОбязательно
policy_idпутьstring (uuid)да

Тело запросаPublishRequest

ПолеТипОбязательно
approval_idstring (uuid)да
resource_sha256stringда
reason_codestringда

Ответы

  • 200Policy
  • 400
  • 401
  • 403
  • 404
  • 409
  • 412
  • 413
  • 415
  • 422
  • 428
  • 429
  • 503

Наборы тестовых сценариев

GET/v1/fixture-manifests

Области доступа
policies:simulate

Platform fixture manifests for SimulationCreate (synthetic scenarios, no personal data).

Параметры

ПолеТипОбязательно
cursorзапросstringнет
limitзапросintegerнет

Ответы

  • 200FixtureManifestList
  • 400
  • 401
  • 403
  • 404
  • 409
  • 412
  • 413
  • 415
  • 422
  • 428
  • 429
  • 503

Версии политики

GET/v1/policies/{policy_id}/versions

Области доступа
policies:read

All versions of the lineage of this policy (linked by previous_version_id), newest first.

Параметры

ПолеТипОбязательно
policy_idпутьstring (uuid)да
cursorзапросstringнет
limitзапросintegerнет

Ответы

  • 200PolicyList
  • 400
  • 401
  • 403
  • 404
  • 409
  • 412
  • 413
  • 415
  • 422
  • 428
  • 429
  • 503

Различия версий политики

GET/v1/policies/{policy_id}/diff

Области доступа
policies:read

Параметры

ПолеТипОбязательно
policy_idпутьstring (uuid)да
againstзапросVersion to compare with; default previous_version_id of the policy.string (uuid)нет

Ответы

  • 200PolicyDiff
  • 400
  • 401
  • 403
  • 404
  • 409
  • 412
  • 413
  • 415
  • 422
  • 428
  • 429
  • 503

Профили политик

GET/v1/policy-profiles

Области доступа
policies:read

Legal basis and retention profiles of the tenant and calibration profiles of released models, for legal_profile_id, retention_profile_id and calibration_profile_ids.

Параметры

ПолеТипОбязательно
kindзапросbasis or retention: tenant legal profiles of this kind; calibration: calibration profiles of released models (one page); absent: basis and retention profiles.enum: basis, retention, calibrationнет
cursorзапросstringнет
limitзапросintegerнет

Ответы

  • 200PolicyProfileList
  • 400
  • 401
  • 403
  • 404
  • 409
  • 412
  • 413
  • 415
  • 422
  • 428
  • 429
  • 503