API contracts

Валидация, статусы и предсказуемые ответы.

BackendRESTvalidationAPI

Когда использовать

Design HTTP APIs with explicit input and response contracts.

Решения для реализации

  1. Define methods, content type, bounds and response shapes first.
  2. Separate malformed JSON from structurally invalid data.
  3. Use stable error codes and do not return stack traces.
  4. Allow CORS only for intended origins; wildcard is suitable for public read APIs without credentials.

Как проверить результат

  • Oversized and malformed requests fail predictably.
  • Client prices are ignored.
  • Error envelopes match documentation.

Работающий пример

POST/api/quote
Нажмите «Отправить», чтобы получить ответ сервера.

Сервер считает сумму по своему каталогу. Заказ и платёж не создаются.

Файлы

SKILL.mdapp/api/quote/route.ts
WEBCRAFT © 2026Оригинальные исходники и интерактивные примерыMIT License