Help Center/ API Gateway/ User Guide (Kuala Lumpur Region)/ API Calling/ Calling Published APIs/ Calling APIs
Updated on 2022-08-12 GMT+08:00
View PDF

Calling APIs

Obtaining APIs and Documentation

Before calling APIs, obtain the request information from the API provider, including the access domain name, protocol, method, path, and request parameters.

Obtain APIs: from your company or from a partner

Obtain related documentation from the help center of the API provider's official website:

The authentication information to be obtained varies with the API authentication mode.

  • App authentication:
    • Signature authentication: Obtain the key and secret (or client AppKey and AppSecret) of the app authorized for the API from the API provider as well as the SDK for calling the API.
    • Simple authentication: Obtain the AppCode of the app authorized for the API from the API provider.
    • Other authentication modes: Obtain the key and secret (or client AppKey and AppSecret) of the app authorized for the API from the API provider.
  • IAM authentication: The account credential (token or AK/SK obtained with the account and password) obtained on the cloud service platform is used for authentication. If the AK/SK is used for authentication, you also need to obtain the SDK from the API provider for calling the API.
  • Custom authentication: Obtain the custom authentication information to be carried in the request parameters from the API provider.
  • None: No authentication information is required.

Calling an API

  1. Set the request path.

    Scenario

    Request Parameter Configuration

    Calling an API with a domain name

    Call the API using the subdomain name allocated to the API group or a domain name bound to the group. No additional configuration is required.

    Calling an API in the DEFAULT group with an IP address

    In the shared gateway, call an API in the DEFAULT group with an IP address. No additional configuration is required.

  2. Set the authentication parameters.

    Authentication Mode

    Request Parameter Configuration

    App authentication (with a signature)

    Use the SDK to sign API requests. For details, see section "Calling APIs Through App Authentication" in the API Gateway Developer Guide.

    App authentication (through simple authentication)

    Add the header parameter X-Apig-AppCode and set the parameter value to the AppCode obtained in Obtaining APIs and Documentation. For details, see Getting Started.

    App authentication (with app_secret)
    • On the Configuration Parameters tab page of a dedicated gateway, the app_secret parameter has been set to on to enable app_secret authentication and app_api_key has been set to off to disable app_api_key authentication.
    • Add the header parameter X-HW-ID and set the parameter value to the key of the app authorized for the API or the client AppKey.
    • Add the header parameter X-HW-AppKey and set the parameter value to the secret or AppSecret obtained in Obtaining APIs and Documentation.

    IAM authentication (with a token)

    Obtain a token from the cloud platform and carry the token in API requests for authentication. For details, see section "Token Authentication" in the API Gateway Developer Guide.

    IAM authentication (with AK/SK)

    Use an SDK to sign API requests. For details, see section "AK/SK Authentication" in the API Gateway Developer Guide.

    Custom authentication

    Carry authentication information in API request parameters for authentication.

    None

    Call APIs without authentication.

Parent topic: Calling Published APIs