A) начать с OpenAPI или B) с примера JSON?
Выберите A, если контракт уже есть и нужны документация и типы. Выберите B, если доступны только payload, но проверьте выведенную схему перед её утверждением.
Elysia Tools
Навигация
Workflow Playbook
Определите API-контракт, проверьте схемы и сохранённые payload, найдите риски совместимости и зафиксируйте приёмку.
Темы
Определите API-контракт, проверьте схемы и сохранённые payload, найдите риски совместимости и зафиксируйте приёмку.
Это руководство превращает заявленную задачу в проверяемый результат. Сохраняйте исходник, промежуточные результаты и решения, чтобы следующий участник понимал, что было проверено и почему.
Подготовьте источник OpenAPI или JSON Schema либо показательный JSON-payload.
Заранее задайте правила совместимости, обязательные поля, тестовые случаи и пороги приёмки.
Решение: A) начать с OpenAPI или B) с примера JSON?. Выберите A, если контракт уже есть и нужны документация и типы. Выберите B, если доступны только payload, но проверьте выведенную схему перед её утверждением.
Получите типы и документацию из OpenAPI или черновую схему из примера; сохраните версию и случаи для проверки. Используйте openapi-to-typescript-generator, api-doc-generator, json-schema-generator.
Проверьте обычные и ошибочные payload, при необходимости подготовьте код проверки во время выполнения и классифицируйте разрывы между версиями. Используйте json-schema-validator, json-schema-to-zod-schema-converter, openapi-diff-breach-detector, api-breaking-changes-detector-migration-planner.
Проверьте сохранённые ответы, сравните известные payload и сгенерируйте граничные или мутированные случаи; не выдавайте это за развёртывание или live-мониторинг. Используйте api-response-contract-validator, api-response-diff-semantic-analyzer, api-contract-stress-tester, api-contract-mutation-tester, api-mock-server.
Руководство по рабочему процессу
Получите типы и документацию из OpenAPI или черновую схему из примера; сохраните версию и случаи для проверки.
Проверьте обычные и ошибочные payload, при необходимости подготовьте код проверки во время выполнения и классифицируйте разрывы между версиями.
Проверьте сохранённые ответы, сравните известные payload и сгенерируйте граничные или мутированные случаи; не выдавайте это за развёртывание или live-мониторинг.
Выберите A, если контракт уже есть и нужны документация и типы. Выберите B, если доступны только payload, но проверьте выведенную схему перед её утверждением.