Files

2.0 KiB

type, title, description, tags, timestamp, story_id, status
type title description tags timestamp story_id status
User Story Receive standardized API errors Application-owned HTTP APIs expose RFC 9457 Problem Details matching game-ingest-server conventions.
api
errors
rfc9457
contracts
2026-08-01T18:43:58Z US-014 verified

User Story

As an API consumer, I want errors returned as standardized Problem Details, so that failures can be handled consistently across game services.

Acceptance Criteria

  • Error responses use application/problem+json.
  • Responses require type, title, and status and optionally include detail, instance, and extensions.
  • Invalid Velocity payloads include machine-readable Zod issues under extensions.issues.
  • Missing credentials, expired requests, replays, unsupported media, unsupported methods, unknown routes, and service failures have stable urn:error:* types.
  • Unexpected application-owned Velocity errors are converted to safe 503 problems without internal details.
  • A normal whitelist denial remains a successful 200 authorization decision.
  • Browser form redirects remain accessible HTML flows and OAuth protocol responses remain owned by NextAuth.

Implementation

Validation

Related Stories

Citations

[1] RFC 9457 — Problem Details for HTTP APIs