Make your First API Call

to make your first api call, you will need an access token follow the steps below to get an access token using the postman prerequisite ensure you have an account with os1 developer portal you have registered an app https //docs getos1 com/registering your app on the os1 platform you have the client id and client secret obtained from the app details page step 1 create an account with postman https //www postman com/ if you don't already have one step 2 download & import os1 postman collection to your postman account by following the below steps download the latest postman collection to your system 2\ save it on your system 3\ go back to postman application > collections > click on the import button 4\ import the recently downloaded os1 postman collection v3 9 1 file from your system step 3 import the environment file to postman account 1\ download the latest environment file to your system https //archbee doc uploads s3 amazonaws com/k 0lkgcxoczhryqvwnrlq vlppxekmobfaa9n43xnop 20240910 101124 json 2\ go back to your postman account and select the environments tab 3\ import the recently downloaded os1 environment file from your system 4\ click continue this imports the environment variables that you'll use for the collection 5\ next, add the values of the variables to the environment file table before that, make sure the correct osi environment file is selected 6\ navigate to the environments tab > osi environment file 7\ add the variables listed in the below table true false 137,157,165false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type note you will get the client id, secret, tenant url, and tenant id after registering an app on os1 platform developer portal for more information about registering an app, see getting started with apps and solutions https //docs getos1 com/getting started with apps and solutions ensure that the variable values used in the above screenshot are made up and will not work if used to make a request step 4 generate access token select coreos services go to token click send to make a post request to receive the token see the sample access token in the screenshot below 4\ add this access token to the environment file note ️ the access token has an expiry of upto 24 hours if after running an api, it says the token is expired, you can simply generate a new one by following the same steps mentioned in step 3 step 4 make first api call with any of the services listed in your postman collection, navigate to coreos services choose location service > countries > get all countries double check that the token and tenantid variables match the values you entered in the collection click send to make your first api call