API sandbox Redacto

Краткая инструкция для интеграторов. Все примеры ниже используют только синтетические данные.

Ограничения sandbox

• Sandbox предназначен только для синтетических тестовых данных.
• Не отправляйте реальные персональные данные, реальные документы, реальные JWT и реальные словари восстановления.
• Ключ действует 7 дней, лимиты по умолчанию: 20 запросов в час и 200 запросов всего.
• Максимальный размер body в sandbox v1: 2 MB.

Авторизация

После подтверждения email лендинг показывает API key один раз. Используйте его как Bearer token:

Authorization: Bearer rdx_sbx_<keyId>_<secret>

Base URL

https://sandbox-api.redactoapp.ru

Text anonymize

curl -sS https://sandbox-api.redactoapp.ru/v1/anonymize/text \
  -H 'authorization: Bearer rdx_sbx_0011223344556677_<secret>' \
  -H 'content-type: application/json' \
  -d '{
    "text": "Тестовый контакт synthetic-dev@example.test",
    "enableNer": false
  }'

Text restore

Словарь из ответа anonymize считается чувствительным артефактом даже в sandbox. Не пишите его в логи и тикеты.

curl -sS https://sandbox-api.redactoapp.ru/v1/restore/text \
  -H 'authorization: Bearer rdx_sbx_0011223344556677_<secret>' \
  -H 'content-type: application/json' \
  -d '{
    "text": "Тестовый контакт [EMAIL_1]",
    "dictionary": {
      "version": 1,
      "mapping": { "[EMAIL_1]": "synthetic-dev@example.test" }
    }
  }'

Файлы

Файловые endpoints принимают .txt, .csv, .docx, .xlsx и .pptx. Ответ anonymize file — ZIP с санитизированным файлом и *.dict.json.

curl -sS https://sandbox-api.redactoapp.ru/v1/anonymize/file \
  -H 'authorization: Bearer rdx_sbx_0011223344556677_<secret>' \
  -F 'file=@synthetic-contract.txt' \
  -o redacto-sandbox-result.zip

Ошибки доступа

• 401 auth_required — нет Bearer-заголовка.
• 401 auth_rejected — ключ повреждён, истёк, отозван или не совпал hash.
• 403 scope_required — у ключа нет нужного scope.
• 429 quota_exceeded — превышен hourly или total limit.