List apps
GET /apps
Retrieves a list of apps visible to the requesting user. Visibility:
- Includes apps shared with the user as a collaborator.
- When accessed using a user's access token: The response should only include apps that are available in the user's country.
Query parameters
categoriesarrayList of app categories
unique itemspublicListbooleanThe public list query parameter determines whether the response will include all apps or only apps the current user has access to.
Responses
200OK
Content application/json
The response is an array of apps that the user may access.
Properties
idstring✻The app ID is a unique identifier for an app.
format: uuidExample
"9352258f-0263-47d1-b9c7-16cd93be7501"namestring✻The unique name of the app using only lowercase letters, numbers and hyphens.
1..256 characters/^[a-z0-9-]+$/iExample
"hda"titlestring✻descriptionnull | stringThe description is a short description of what the app does.
1..512 charactersExample
"This app will help you manage your diabetes"iconnull | stringThe icon is a URL to the app's icon. It should be a valid URL and should point to an image file.
format: uri1..131072 charactersurlstring✻The URL is the full URL to the app's homepage.
format: uri1..1024 charactersExample
"https://www.sugarsense.com"privacyNoticeUrlnull | stringThe URL is the full URL to the app's privacy notice.
format: uri1..1024 charactersExample
"https://example.com/privacy-notice"setupUrlnull | stringThe URL is the full URL to the app's setup page.
format: uri1..1024 charactersExample
"https://example.com/setup"categoriesarray✻List of app categories
unique itemscountriesarray✻List of country codes
unique itemsThe two-letter (A-2) ISO 3166-1 code for the user's country of residence. Only countries supported by Hedia are allowed.
"AT""CL""DE""DK""ES""FR""GB""IE""IT""LU""MT""PL""SE"Example
"DK"privateboolean✻The privacy level of the app.
firstPartyboolean✻The firstParty property determines whether or not an app is owned by Hedia.
ownerIdstring✻The owner ID is a unique identifier for an owner (either a user or an app).
createdAtstring✻- format: date-time
createdBystring✻- format: uuid
updatedAtstring- format: date-time
updatedBystring- format: uuid
Security
Servers
id.hedia.comhttps://id.hedia.com/api/v1