Early preview notice
Note: This is an early preview. API operations may change, and data in the staging environment may be modified or removed without prior notice.
Important limitation: The SKF staging environment is only available during EU office hours.
SKF integration environments
The staging environment is normally not available to TSPs but has been temporarily opened to support testing of this feature.
The staging environment is fully separated from the production environment. Although you may already have a logical setup in production for development purposes, that setup must not be used for early testing of this feature.
Setting up your api client for the skf staging environment
You will need:
- A dedicated Client ID and Client Secret (to be provided)
- An API account in the staging environment (to be provided)
Token endpoint:https://am.dev.gravitee.skf.com:8092/skf-staging/oauth/token
Interacting with the trax api
The TraX API in staging behaves similarly to the production API.
Base path:https://staging.snaplogic.skf.com/trax
Timing considerations
- Adding or removing an access rule grants or revokes user access within a few minutes.
- Changes to users in an installer company that already has an access rule are processed every 30 minutes in this environment. When you add a user to such a company, it may take up to 30 minutes before access is granted.
Running tests
The API enforces a blacklist for free email provider domains. For testing purposes, you may use domains with the following suffixes: .test, .example, .invalid, or .localhost.
Example: east-tsp.test
What you can test via the trax api
- Creating installer companies
- Adding users
- Setting access rules
Additional validation
Validating user access requires access to the user’s email inbox, which can be challenging when using test domains.
Workaround: You may manually create an account with a free email provider through SKF support and use those credentials to log in to the TraX mobile app connected to the SKF staging environment.
To access the TraX mobile app connected to staging, sign up for testing using the invitation link (currently Android-only).
Finally, any fleets and vehicles involved in testing must be registered in advance:
- Create fleets using
POST /fleets - Upload vehicles using
POST /fleets/{fleetId}/vehicles