Help Center> ROMA Connect> Developer Guide> Developer Guide for Service Integration> Using App Authentication to Call APIs> curl
View PDF

curl

Scenarios

To use the curl command to call an API through App authentication, download the JavaScript SDK to generate the curl command, and copy the command to the CLI to call the API.

Prerequisites

  • You have obtained the domain name, request URL, and request method of the API as well as the key and secret (or AppKey and AppSecret of the client) of the integration application. For details, see Preparations.
  • The browser version is Chrome 89.0 or later.

API Calling Example

  1. Use the JavaScript SDK to generate the curl command.

    Log in to the ROMA Connect console, choose API Connect > API Calling, download the SDK, and decompress it.

    Open demo.html in a browser. The following figure shows the demo page.

  2. Specify the key, secret, method, protocol, domain name, and URL. Example: 

    1
2
3
4
    		 
    Key=4f5f626b-073f-402f-a1e0-e52171c6100c
Secret=******
Method=POST
Url=https://c967a237-cd6c-470e-906f-a8655461897e.apigw.exampleRegion.com

  3. Specify query and header parameters in JSON format, and set the request body.
  4. Click Send request to generate a curl command. Copy the curl command to the CLI to access the API. 

    //If the subdomain name allocated by the system is used to access the API of HTTPS requests, add -k to the end of -d to ignore the certificate verification. 
$ curl -X POST "https://c967a237-cd6c-470e-906f-a8655461897e.apigw.exampleRegion.com/" -H "X-Sdk-Date: 20180530T115847Z" -H "Authorization: SDK-HMAC-SHA256 Access=071fe245-9cf6-4d75-822d-c29945a1e06a, SignedHeaders=host;x-sdk-date, Signature=9e5314bd156d517******dd3e5765fdde4" -d ""
Congratulations, sdk demo is running

    The curl command generated using an SDK does not meet the format requirements of Windows. Please run the curl command in Git Bash.