[field-notes] Document second error format: 412 + bare JSON array of Spring validation codes #68

Closed
opened 2026-09-09 14:13:04 +00:00 by mat · 0 comments
Owner

Roadmap section: 2.3 Second error format (README.md error conventions)

  • Besides RFC-7807 problem+json, the API also returns a bare JSON array of Spring validation errors with HTTP 412:
    [{"codes":["user.already.activated"],"arguments":[],
      "defaultMessage":null,"objectName":"","code":"user.already.activated"}]
    
    Observed on users/{id}/refreshtoken, gateways/{id}/network,
    companies/installation-company-by-installer-email. Note that anything
    assuming problem["detail"] breaks on these (list, not dict), and add
    412 to the documented status codes.

From the 2026-09 re-exploration lineage of energy.comwatt.com (reverse-engineered as END_USER against SPA bundle main.5d426c11.js, live-probed 2026-08-15; no official API exists). Re-verify against the live API before relying on any claim. Migrated from ROADMAP.md when it was retired.

**Roadmap section: 2.3 Second error format (README.md error conventions)** - Besides RFC-7807 `problem+json`, the API also returns a **bare JSON array of Spring validation errors** with HTTP **412**: ```json [{"codes":["user.already.activated"],"arguments":[], "defaultMessage":null,"objectName":"","code":"user.already.activated"}] ``` Observed on `users/{id}/refreshtoken`, `gateways/{id}/network`, `companies/installation-company-by-installer-email`. Note that anything assuming `problem["detail"]` breaks on these (list, not dict), and add `412` to the documented status codes. --- *From the 2026-09 re-exploration lineage of `energy.comwatt.com` (reverse-engineered as `END_USER` against SPA bundle `main.5d426c11.js`, live-probed 2026-08-15; no official API exists). Re-verify against the live API before relying on any claim. Migrated from `ROADMAP.md` when it was retired.*
mat closed this issue 2026-10-11 11:06:51 +00:00
Sign in to join this conversation.
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
mat/python-comwatt-client#68
No description provided.