User story: Application consumes Location API

Pre condition

• The application has been onboarded and deployed on Operator’s network
• The application has obtained OAuth2 access tokens and the end-user’s consent for location retrieval (i.e., the app has valid API credentials available).

Steps

• The application requests an access token from OEG using its client credentials.
• The application calls the POST /retrieve endpoint
• OEG authenticates and validates the consent
• OEG queries the operator’s network for the device’s location.
• OEG returns the device’s location in CAMARA-compliant JSON
• The application processes the location (e.g., plots on a map, triggers a location-based service).

Post condition

The application receives a location payload in CAMARA-compliant JSON format.