Skip to main content

Integration Overview

This document describes the JalapenoCloud Open Platform API integration process from a developer's perspective, helping you quickly locate key steps during integration.

1. Roles and Services

  • End User: Manages AccessKeyID / SecretAccessKey (AK/SK) in the jalapenocloud.cn console.

  • Developer Application: Uses AK/SK to call openapi.jalapenocloud.cn to perform various management operations.

2. Obtain and Refresh Credentials

  1. Log in to the JalapenoCloud Platform.

  2. Create new AK/SK or rotate existing keys in the "Key Management" page.

  3. Copy the key pair and store it securely locally.

3. Request Signing and Authentication

All management API requests must carry digital signatures based on AK/SK. The signing process is outlined below:

  1. Construct request basic information (method, URL, query parameters, request body).

  2. Calculate the Content-Digest header to ensure the request body is not tampered with.

  3. Combine signature components and generate Signature-Input, including keyid, created, nonce, and other fields.

  4. Use the Secret Key to perform HMAC-SHA256 on the signature base string to generate the Signature header.

  5. Send the signed request to jalapeno-openapi and wait for server verification.

Detailed signing steps and examples can be found in docs/integration/request.md.