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 request parameters description values clientid get clientid generated from your registered apps credentails page on os1 platform {{clientid}}\ app developerplatform clientsecret get clientsecret generated from your registered apps credentials page on os1 platfrom \<clientsecret> baseurl/tenanturl the root url for api requests or service endpoints specify the path to the sandbox environment you're using https //api os1 dev https //api os1 dev tenantid an identifier for a specific tenant within an organization get tenantid generated from your registered apps credentials page on os1 platform requestid a unique identifier for a specific request, often used for tracking get requestid generated from your registered apps credentials page on os1 platform a random identifier, for example, request123 teamid an identifier for a specific team within an organization get teamid generated from your registered apps credentials page on os1 platform orgid an identifier for the organization in the system get orgid from the organization page url the last part of the url is your orgid it looks similar to this value 833bc3a2 9ccc 424a 8ba3 9d5e9f157e74 appid an identifier for the application within the system get appid generated from your registered apps credentials page on os1 platform 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