Malformed JSON Moderation API Responses in Node.js: Schema Gates Over Adapters

Описание и применение

В сервисе поддержки e‑commerce API модерации возвращают некорректный JSON, что приводит к ошибочным маршрутизациям. Внедрение схемы проверки синтаксиса, структуры и политики предотвращает небезопасные решения, логирует ошибки и перенаправляет на ручной контроль.

Задача

A moderation API can return malformed JSON, causing unsafe routing decisions in an e‑commerce support triage service.

Результат

The schema gate prevents unsafe routing by ensuring only well‑formed, policy‑compliant moderation results are used, reducing errors and making provider changes cheaper.

Рабочий процесс

• 1. Send moderation request through provider adapter.
• 2. Check Content‑Type header for application/json.
• 3. Parse response inside try/catch; on failure throw Malformed JSON error.
• 4. Validate parsed object against expected shape (decision, reason).
• 5. If validation fails, log redacted record and route to fallback (human review or unclassified queue).
• 6. If validation succeeds, use decision to route ticket.
• 7. Measure and log each failure type (syntax, schema, policy).

Доказательства

A malformed moderation response is an untrusted input, not a slightly inconvenient parse error.

Источник

Separate transport success from semantic success. A 200 response can contain truncated JSON, a fenced object, an extra sentence, or a valid object with the wrong fields.

Источник

For a ticket such as “The blender arrived with a cracked jar,” the application needs a small contract: a decision, a reason, and perhaps a confidence value.

Источник