Инструменты пользователя

Инструменты сайта


sharixopen:knowledge:integrations:api_versions

API-контракты: версионирование и источники

Тип: contract · Статус: сведения требуют сверки с действующей установкой; архитектурные правила сформулированы как целевой контракт.

Раздел: Интеграции Open: принцип локального владельца

Публичный договор

Клиент видит явно оговорённые endpoint, схемы payload, идентификаторы, права, ошибки и поддерживаемые версии. Одноимённый объект между сервисами не доказывает совпадение JSON-контракта.

Изменение

Backward compatibility проверяется фактическими потребителями (Open, Platform, Flutter, handlers); не удалять старое поле без deprecation и миграции.

Повтор

POST внешней операции должен иметь устойчивую идемпотентность и корреляцию, иначе сетевой timeout может породить дубликат заказа.

Связанные понятия

sharixopen/knowledge/integrations/api_versions.txt · Последнее изменение: — sx_knowledge_api_open

© 2022 ShariX