Заборонені контракти
- готовий SQL,
select_rowsіunizap2; maintenance, migrations і service registry;- реквізити бази, tenant, URL та внутрішні
action/op; - довільні інтеграції із зовнішніми серверами.
01
Типові помилки
Код HTTP визначає дію клієнта, а поле error.code — точну причину.
| HTTP | Коли виникає | Що робити |
|---|---|---|
400/422 | Некоректний JSON, невідомий параметр або неправильний тип | Не повторювати без виправлення запиту |
401 | Ключ відсутній, відкликаний або прострочений | Перевірити Authorization; для a13s1 отримати новий токен |
403 | Ключ не має потрібного scope | Звірити метод через /v1/operations |
404 | Метод не опублікований | Перевірити точне ім’я методу |
409 | Стан Idempotency-Key не дозволяє виконання | Дотримуватися конкретного коду idempotency |
429 | Перевищено rate limit | Чекати згідно з Retry-After |
502/503 | Upstream недоступний або повернув неприйнятний контракт | Для читання повторити з backoff; запис перевірити за журналом |
02
Що навмисно не публікується
API13 не є універсальним proxy до старого API або бази даних.
Локальні функції Windows
- локальна база каси та її локальна синхронізація;
- драйвери обладнання, локальний друк і файли користувача;
- стан інтерфейсу, stress/test операції та внутрішня телеметрія;
- секрети ПРРО, XML-підпис і приватні ключі.
Відновлення видаленого користувача не опубліковано: чинний upstream відхиляє
цей варіант як
restore_denied. Для нього потрібна окрема серверна доробка.