{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-apis/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition","img"]},"type":"markdown"},"seo":{"title":"How to use API \"Try It\" in SLB Developer","description":"Accelerate E&P application development and protect your innovation by consuming our Data and Domain APIs / Platform APIs.","lang":"en-US","meta":[{"name":"robots","content":"noindex"}],"llmstxt":{"hide":true,"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"how-to-use-api-try-it-in-slb-developer","__idx":0},"children":["How to use API \"Try It\" in SLB Developer"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The API \"Try It\" feature on the SLB Developer site is an interactive tool designed to help users explore and test SLB Cloud API endpoints directly within the documentation interface. It offers a hands-on experience by allowing users to input parameters, send requests, and view real-time responses—all without writing any code. Follow the steps below to get started."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Prerequisites:",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"a. Valid billing account on ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://delfi.slb.com/home"},"children":["SLB Digital platform"]}," & access to ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://developer.delfi.slb.com/workspace/solutions"},"children":["SLB Developer Portal"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"b. Member of a ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://developer.delfi.slb.com/workspace/my-teams"},"children":["team"]}," in SLB Developer Portal."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Application and Client Details from the Developer Portal: Make sure you have the following details related to your application and OAuth Client from Developer Portal."]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"id":"appkey"},"children":["2.a App Key"]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Important!"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Follow below steps only if the SLB cloud API you want to try  requires an app key/ API key to be included in the request header. If the API does not require an app key, you may skip this section and go to ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#client-id-secret"},"children":["2b. Client ID and Client Secret section."]}]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If you have an existing app, visit ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developer.delfi.slb.com/workspace/my-apps"},"children":["My App "]}," page of Developer Portal. Copy the app key value of app from the list of apps, using copy button highlighted in below screenshot.\n",{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/app_key_dev_portal.0dca1f2a999ebccf2361678ad6ef36e97f8250ed43e9c5395e6f48f507cd45bd.6ef056a3.png","withLightbox":true},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[" If you do not have any existing app, follow ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developer.digital.slb.com/app-management#create-an-app\""},"children":["Create an App"]}," guide to create app. Once you create app, follow above steps to get the app key.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]}]}]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"id":"client-id-secret"},"children":["2.b Client ID and Client Secret"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["OAuth clients can be created under an App in the SLB Developer Portal.\n       "]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[" \n       If you obtained the app key using a specific app in the previous step, make sure to use the same app to retrieve the Client ID and Client Secret values. If you do not have any existing app, follow ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developer.digital.slb.com/app-management#create-an-app\""},"children":["Create an App"]}," guide to create App. For existing app, visit ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developer.delfi.slb.com/workspace/my-apps"},"children":["My App "]}," page of Developer Portal. As shown in below screenshot, select the development team and then select the app to view app details. ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/select-app.5fa699ca68c5a8566097ad0f79d41086dda96dc4d5074ce6569345faed196363.6ef056a3.png","withLightbox":true},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[" Click on Client tab to view the list of OAuth clients ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/client_list.1f7caa97c0ff073ad321c55689831dcebc963f066fc916096e8dfbbf7160c34b.6ef056a3.png","withLightbox":true},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[" \n     You can either use existing client or create new client. Refer below sections for details.\n     ",{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"id":"use-existing client"},"children":["Use existing Client"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Choose the Client ID whose Client profile value is of type Web Server application. "]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Add \"https://developer.delfi.slb.com/workspace/oauth-playground\" as one of the redirect URI for this client."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[" You should know the Client Secret. Client Secret is shown during only client creation process."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/client_properties.715f8d293fde23187ed1775c4b866c7b819f4d6ab56007d21a1fb9b66b958834.6ef056a3.png","withLightbox":true},"children":[]}]}]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"id":"use-existing client"},"children":["Create new Client"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[" Click on Add New Client button ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/add-client.8607f556b6d073ea4c5b36d93021aebc4dd98a5be0235f1a92f71f6092387ff8.6ef056a3.png","withLightbox":true},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[" Make sure Client profile should be of type Web Server application. Add \"https://developer.delfi.slb.com/workspace/oauth-playground\" as redirect URI for client ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/client_properties.715f8d293fde23187ed1775c4b866c7b819f4d6ab56007d21a1fb9b66b958834.6ef056a3.png","withLightbox":true},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["After creation of Client, Client ID and Client secret are shown to user. You can use copy button to take note of the Client ID and Client secret. Make sure to copy and paste the secret to safe place as it is not recoverable. Refer below screenshot for details\n",{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/client_id_secret.477d39074b6596c148cd77b77d0db18f5c935e73d2bd2754d7ac7bf76ef68e62.6ef056a3.png","withLightbox":true},"children":[]}]}]}]}]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Now you should have API Key (If API which you want to try require it), Client ID and Client secret value ready to use. Make sure Client configuration is done as mentioned in previous step."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the top right corner of the SLB Developer, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API Reference"]},"."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/api-reference.f7650f67b5dbac43de23ef0aa8060865641ee05aa4ddc348b3543beb662432cf.6ef056a3.jpg","withLightbox":true,"border":"1px solid black"},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click on API name in left side navigation tree of API Reference page. E.g. In below screenshot, API specification for User Context service is shown. Copy the client id value of API as it will be required later during the token generation."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/api-audience.5386d477840b4713a877ddc3e516c7eca8aedc28345c9a231cb760248677dd1d.6ef056a3.png","withLightbox":true,"border":"1px solid black"},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To Try specific end point, select an API endpoint from the left side navigation tree as shown in below screenshot."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/api-endpoint.938e5ce5bae644bcfaa171a527f4cfe71074b300320af808485ec84271abf027.6ef056a3.jpg","withLightbox":true,"border":"1px solid black"},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click on ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["\"Try It\""]}," button."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/try-it.ba484db7788d2464fb9035fd5be571b23fdd4726115d47083bba37542e7bffda.6ef056a3.jpg","withLightbox":true,"border":"1px solid black"},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Select Environment"]},": On \"Try It\" screen, The Environment drop-down in the top right corner lists the available servers. Select the appropriate environment. If you are an existing customer, and this drop-down shows \"Mock server\" or \"https://developer.digital.slb.com/\", contact your SLB support representative to determine the correct server for your API."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/environment.b18abdf0d9cfa0724753f448f78176a079866edeb62b5a8f2aeaf2df1b177444.6ef056a3.png","withLightbox":true,"border":"1px solid black"},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Provide App Key"]},": If the API requires an app key in the request header, enter it on the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Security"]}," tab. Refer ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#appkey-enable-services"},"children":["Step 2"]}," for details on how to get app key."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/app-key.d10a482b60b9426bd0b0d5f2474d4653c19d4094220dbaf1af27608ad3999ca3.6ef056a3.png","withLightbox":true,"border":"1px solid black"},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Provide S-Auth token"]},": An S-Auth token issued by ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://developer.digital.slb.com/solutions/sauth/tutorial/about#slb-authenticator"},"children":["SLB Authenticator"]}," is required to call APIs on the SLB platform. You can get this token using OAuth Playground utlity present in Developer Portal. The OAuth Playground is a zero-code utility where you can perform an OAuth Authorization Code Flow to obtain Access and Refresh tokens. Developers can use the OAuth Playground in the Developer Portal when they want to quickly explore APIs of interest without having to worry about writing complete code for authentication and authorization flow. More detail guide on OAuth playground is present ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://developer.digital.slb.com/guides/cloud-apis/developer-portal/oauth-playground"},"children":["here"]},". However below steps will be sufficient in this context.  Follow below steps to get S-Auth token"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Launch the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://developer.delfi.slb.com/workspace/oauth-playground"},"children":["OAuth playground"]}," from the SLB Developer Portal."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Input Client ID and Client Secret you got in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#client-id-secret"},"children":["step  2"]},". Click on Confirm button as highlighted in below screenshot"]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/oauth-step1.5bead0248a1fb5d02c760c7115cdce32ab2e5e5653d16b9a650d83b67038e2d3.6ef056a3.png","withLightbox":true,"border":"1px solid black"},"children":[]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["On the next screen, either select an API from the predefined list or manually enter the API Client ID. Refer step 5 to know how to get the API Client ID. The screenshot below demonstrates how the API Client ID for the User Context Service was added manually."," ","You may enter multiple API Client IDs, separated by spaces, in the designated input field."," ","Click the Authorize API button."]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/oauth-step2.cbfffe6123aead1c14a1110cc48b3c1b194ab9facdf0928d0a5fa92c9bc62fd7.6ef056a3.png","withLightbox":true,"border":"1px solid black"},"children":[]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click the Exchange Tokens button as shown in the screenshot. This will generate a new access token that can be used to call the API. Click the Copy button to copy the token, as illustrated in the screenshot."]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/oauth-step3.e52b4f56b6ae54e3dc78ab707855d3437eaa052548fc697b4679c745f63e5dad.6ef056a3.png","withLightbox":true,"border":"1px solid black"},"children":[]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Return to the API \"Try It\" screen and navigate to the Security section."," ","Set the Authorization Type to JWT."," ","Paste the S-Auth token (access token) obtained from the OAuth Playground into the highlighted input field, as shown in the screenshot below."]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/jwttoken.86ba29a7e916d5b353e1ab4590ce29990b72c40e0993991274da16c13d771136.6ef056a3.jpg","withLightbox":true,"border":"1px solid black"},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Provide Input Parameteres"]},": If the API requires additional input in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["body"]}," or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["query"]}," parameters, you can provide this on the corresponding tabs."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/body-query-param.987187aa6375d187be3dd90df3dec6dd87915f8ebc3f07ef56bafd1c13e6b18d.6ef056a3.jpg","withLightbox":true,"border":"1px solid black"},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Provide Additional headers"]},": Some APIs may require additional headers, such as \"data-partition-id\"."," ","Provide these values in the Headers section of the \"Try It\" screen, as shown in the screenshot below."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/try-it-datapartition-header.2a84ad8bd83568f8ed33bd18a4433c948b9031b2c4d5f3c69e94bf32e3fd10ba.6ef056a3.png","withLightbox":true,"border":"1px solid black"},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once all input is provided, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Send"]}," to call the API endpoint."]}]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/sendrequest.898b1570be2940454524b1fe6c7217906c46911393ca244544ad7a8fc306493a.6ef056a3.jpg","withLightbox":true,"border":"1px solid black"},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"\n14. The API response, including the status code and response body, is displayed at the bottom of the page, as illustrated in the screenshot below.  \n",{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/response.560b258ab570d1c9571510d24854785a8feb037e7902d38421f561a538a7c2d8.6ef056a3.jpg","withLightbox":true,"border":"1px solid black"},"children":[]}]},"headings":[{"value":"How to use API \"Try It\" in SLB Developer","id":"how-to-use-api-try-it-in-slb-developer","depth":1}],"frontmatter":{"seo":{"title":"How to use API \"Try It\" in SLB Developer"}},"lastModified":"2026-06-03T19:07:56.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/api-tryit-usingoauthplayground","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}