Developer Guide
Created: 24-11-2023 07:22:15 by Computerome
Updated: 25-04-2025 09:16:12 by Computerome
Introduction
This guide contains information on how to use the DELPHI/Cloud API endpoints.
Since our API uses jwt and two factor authentication you will need to obtain a valid jwt by using the authentication api before submitting to other apis.
We are currently working on offering a method where you as a developer will be able to use an api key instead. This feature will only be allowed when running your scripts inside a DELPHI/Cloud Virtual Machine.
Testing endpoints
Computerome recommends that you use Postman or similar developer tool in order to view our API endpoints and methods you can call.
The following are the available endpoints:
- Authentication
- Project Management
- Project Application
- Assignments
- Onboarding
- Resource Usage Reports
- Notifications
- Cloud Data Import
- Cloud Data Export
- Cloud Data Transfer
We have created a sample Postman collection for developers.
Please note that this sample project is not always up to data and we recommend you import the swagger files from the above endpoints in you project
In order to use this Postman collection please read this example to get you started.
After installing you can click "import" and import the unzipped "Computerome.dk.postman_collection.json"
Select the folder "Computerome.dk" and then the "Authorization" tab.
Under "Token" section type the variable "{{token}}". This will allow the jwt token be reused throughout the project.You should now be able to run the following in sequence.
- run Auth -> login -> User login request
- Validate user in identity app
- token variable should be set
- run Auth -> userinfo -> Get info about currently authenticated Delphi user
If all went well you should be able to view your logged in user information.
Authentication
The "User login request" call sets the token test tab.
You now can run any api call using this chained jwt token.
In Postman you can also view the curl command you need for your script using the code tab.