Available tapio APIs to use in your Applications
This page contains an overview on all APIs that are currently available for third party developers, to integrate tapio ecosystem features within their applications.
Before using one of the APIs below, we highly recommend to read our authentication guide
Common URLs used to Authenticate
We're using some services provided by Microsoft, to authenticate applications and users against the tapio ecosystem. Therefore, you need to know some common Login URLs, to get the tokens you need, depending on the OAuth flow you're using. As microsoft is also evolving their service constantly, there have been recent changes to the login URLs. We recommend, to use the new OAuth Token V2 endpoint to perform OAuth and OIDC authentication, because it's backwards compatible and can provide tokens for all kinds of services.
The Authority is: https://login.microsoftonline.com/tapiousers.onmicrosoft.com
The Authorization Endpoint is: https://login.microsoftonline.com/tapiousers.onmicrosoft.com/oauth2/v2.0/authorize
The Token Endpoint is: https://login.microsoftonline.com/tapiousers.onmicrosoft.com/oauth2/token
Available APIS
| API Name | Purpose | Base Url | Detailed Documentation Available | Authentication Flow | ResourceId |
|---|---|---|---|---|---|
| Core API | Retrieve machine states and send commands to a machine | https://core.tapio.one/ | Access Machine States, -read Historical Data, Send Commands to a Machine | Client Credential Flow | https://tapiousers.onmicrosoft.com/CoreApi |
| Global Discovery Service API | Retrieve the profile of a user, including assigned subscriptions and machines | https://globaldisco.tapio.one/ | Retrieve Profile of a User, API Reference | Client Credential Flow | https://tapiousers.onmicrosoft.com/GlobalDiscoveryService |
| Management API | Create and manage your tapio machines | https://api.tapio.one/management | Manage your Machines | Client Credential Flow | https://tapiousers.onmicrosoft.com/ManagementApiGateway |
| Application API | Enables third party applications to interact with tapio on behalf of their users | https://api.tapio.one/application | API Reference | Authorization Code Flow | https://tapiousers.onmicrosoft.com/7ee7f1b0-d030-4d20-9691-9752bdb44315 |
Policies
If you have further questions on our APIs, how to use them, don't hesitate to contact us at developer@tapio.one.