sharixopen:knowledge:integrations:api_versions
Содержание
API-контракты: версионирование и источники
Тип: contract · Статус: сведения требуют сверки с действующей установкой; архитектурные правила сформулированы как целевой контракт.
Публичный договор
Клиент видит явно оговорённые endpoint, схемы payload, идентификаторы, права, ошибки и поддерживаемые версии. Одноимённый объект между сервисами не доказывает совпадение JSON-контракта.
Изменение
Backward compatibility проверяется фактическими потребителями (Open, Platform, Flutter, handlers); не удалять старое поле без deprecation и миграции.
Повтор
POST внешней операции должен иметь устойчивую идемпотентность и корреляцию, иначе сетевой timeout может породить дубликат заказа.
Связанные понятия
sharixopen/knowledge/integrations/api_versions.txt · Последнее изменение: — sx_knowledge_api_open