Feature: Infrastructure Kernel Support for JSON-LD and Hypermedia #11

New issue

Closed

opened 2026-07-04 21:32:10 +00:00 by psycodepath · 0 comments

psycodepath commented

2026-07-04 21:32:10 +00:00

Owner

Motivation

Provide a standardized response helper and serializer mechanism to render JSON-LD and hypermedia formats consistently across all API endpoints.

Description

Create reusable HTTP response helper classes, serialisation structures, and paging templates aligned with Hydra's specification.

User Story

As a developer, I want to reuse JSON-LD responses so that API development is consistent and simple.

Gherkin Feature

Feature: Kernel API Response Utilities
  As the HRP application
  I want to format responses as JSON-LD with hypermedia links
  So that api clients can discover relationships and navigate paginated lists

Acceptance Criteria

Reusable JsonLdResponse class in Kernel/Infrastructure/Web.
Serializer support for hydra:Collection containing pagination fields (hydra:first, hydra:next, etc.).
Unified error format serialized in JSON-LD.
Basic unit tests for serialization and pagination helper logic.

### Motivation Provide a standardized response helper and serializer mechanism to render JSON-LD and hypermedia formats consistently across all API endpoints. ### Description Create reusable HTTP response helper classes, serialisation structures, and paging templates aligned with Hydra's specification. ### User Story As a developer, I want to reuse JSON-LD responses so that API development is consistent and simple. ### Gherkin Feature ```gherkin Feature: Kernel API Response Utilities As the HRP application I want to format responses as JSON-LD with hypermedia links So that api clients can discover relationships and navigate paginated lists ``` ### Acceptance Criteria - [ ] Reusable `JsonLdResponse` class in `Kernel/Infrastructure/Web`. - [ ] Serializer support for `hydra:Collection` containing pagination fields (`hydra:first`, `hydra:next`, etc.). - [ ] Unified error format serialized in JSON-LD. - [ ] Basic unit tests for serialization and pagination helper logic.

psycodepath added this to the v1.4.0-rest-api milestone

2026-07-04 21:32:10 +00:00

psycodepath self-assigned this

2026-07-04 21:32:10 +00:00

psycodepath referenced this issue from a pull request that will close it,

2026-07-04 21:39:27 +00:00

feat(kernel): add support for JSON-LD, Hydra collections and errors #15

psycodepath closed this issue

2026-07-04 21:43:10 +00:00