Sari la conținut
gStack

Checklist conformitate Standard API (`CU-API-003..006`)

Acest conținut nu este încă disponibil în limba selectată.

Self-check pentru dezvoltatori/spec-writeri ÎNAINTE de review. Auditul automat (/api-audit) verifică aceleași puncte.

Structură & zone

Section titled “Structură & zone”
  • Toate căile sub /api/v{N}/ (cu versiune majoră).
  • Fiecare cale are o zonă validă: public | citizen | staff | admin | app.
  • Resurse = substantive plural, lowercase, kebab-case. Fără verbe în cale (acțiunile = sub-resurse imperative).
  • Audiențele nu se amestecă pe același prefix; RBAC aplicat peste zonă.

Operațional (uniform pe toate sistemele)

Section titled “Operațional (uniform pe toate sistemele)”
  • GET /health/live și GET /health/ready (cu checks DB/Redis/ES/RabbitMQ/storage).
  • GET /metrics (Prometheus) cu etichete service,version,zone,method,route,status.
  • GET /info (service/version/commit/builtAt).
  • GET /api/v1/openapi.json complet și valid.

Payload & convenții

Section titled “Payload & convenții”
  • Erori RFC 7807 (problem+json) cu correlationId.
  • Paginare page/size + plic {items,page,size,total}.
  • Accept-Language RO/RU; X-Correlation-Id propagat; date ISO 8601 UTC.
  • Idempotency-Key pe scrieri externe; coduri de status din setul standard.

Versionare & contract

Section titled “Versionare & contract”
  • OpenAPI 3.x publicat; operationId = {zona}.{resursă}.{acțiune}.
  • Breaking change → versiune majoră nouă; deprecare via Sunset/Deprecation.

Cazuri de test asociate în biblioteca-cazuri-test-comune.md: TC-COM-API-03..06.