[Pro 2023] Accessing the WebAPI of my App

Developers
,
1

I have created a REST API according to the instrucions for a Web API.
Now I would like to use Postman to access this REST API using the URL:
http://<IP address of my Homey>/api/app/nl.das.pidevice/metric?name=Metric1
Without using authentication I get the error:

{
    "error": "Missing Session",
    "error_description": "Missing Session",
    "stack": "Error: Missing Session\n    at file:///app/lib/ManagerApi.mjs:81:25\n    at processTicksAndRejections (node:internal/process/task_queues:95:5)",
    "statusCode": 401,
    "statusName": "HomeyErrorUnauthorized"
}

So I suppose I need to use some kind of authentication. I tried Basic with my email and password, but that didn’t work.
If I need OAuth2 using the developer ClientID and ClientSecret then I need to have the Auth URL, Access Token URL and Refresh Token URL of the OAuth2 provider. But these are not published by Athom as far as I can google…

Anyone any suggestions how to continue?

2
3

Thanks, Robert, it works like a charm if you use the “Bearer Token” authorization and not the “API token” authorization in Postman :+1:

By the way: Why is this page not incorporated in the WebAPI documentation?

4

Updating the documentation doesn’t have a huge priority for Athom.