generated from camaraproject/Template_API_Repository
-
Notifications
You must be signed in to change notification settings - Fork 9
Open
Description
Problem description
The current asynchronous response mechanism in Population Density Data does not follow the CloudEvents delivery format as required by CAMARA Commonalities r3.3. Instead, it uses a custom JSON structure (application/json), which is inconsistent with the agreed CAMARA standard for asynchronous responses and notifications.
This creates a risk of fragmentation, as API consumers integrating multiple CAMARA APIs would need to implement different delivery models.
Expected behavior
- The asynchronous response should use CloudEvents format (application/cloudevents+json) as the delivery mechanism.
- The payload of the asynchronous response should be wrapped inside the data field of a CloudEvent.
- All required CloudEvent attributes (e.g. id, source, specversion, type, datacontenttype, time) should be present.
- Event type should follow the CAMARA naming conventions, e.g. org.camaraproject.population-density-data-v0.population-density-async.
Alternative solution
No alternative solution is proposed. Alignment with CloudEvents is mandatory per Commonalities, but not blocking to the Fall25.
Additional context
- The current design was already merged and passed review.
- During the RC review of PredictiveConnectivityData, the same issue was identified. Both APIs need to be aligned.
- Agreement is to keep the current Fall’25 release as is, and to correct this post-Fall’25.
- The correction will be delivered as v0.2.0, following the dual-phase model, to ensure consistent compliance across APIs.
Metadata
Metadata
Assignees
Labels
No labels