# Alibaba Cloud OpenAPI Portal Services API

> Alibaba Cloud OpenAPI Portal Services API on Apizie: 25 endpoints (Validates the syntax of HashiCorp Configuration Language (HCL) for Terraform, Creates an API MCP service, Creates an ApiMcpServerCore, Deletes a single API MCP service, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/cloud:aliyun-openapiexplorer/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:aliyun-openapiexplorer`
- Category: Cloud
- Status: byok
- Source: https://api.alibabacloud.com/product/openapiexplorer
- Page: https://zieapi.vercel.app/api/cloud/aliyun-openapiexplorer
- OpenAPI: https://zieapi.vercel.app/api/cloud/aliyun-openapiexplorer/openapi.json

Alibaba Cloud OpenAPI for OpenAPI Portal Services (openapiexplorer, version 2024-11-30). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Validates the syntax of HashiCorp Configuration Language (HCL) for Terraform
`POST https://zieapi.vercel.app/v1/cloud:aliyun-openapiexplorer/api-mcp-server-validate-hcl` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://openapi-mcp.ap-southeast-1.aliyuncs.com |
| code | string | no | The content of the Terraform HCL code. For more information, see HCL language overview… |

### Creates an API MCP service
`POST https://zieapi.vercel.app/v1/cloud:aliyun-openapiexplorer/create-api-mcp-server` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://openapi-mcp.ap-southeast-1.aliyuncs.com |
| additionalApiDescriptions | array | no | The list of supplementary API descriptions |
| apis | array | yes | The list of APIs to add. This parameter cannot be empty |
| assumeRoleExtraPolicy | string | no | The additional policy for role assumption when multi-account access is enabled. When this policy is specified, the permissions for role… |
| assumeRoleName | string | no | The name of the RAM role to assume in the target account when performing cross-account operations with multi-account access enabled |
| clientToken | string | no | The client token that is used to ensure the idempotence of the request. Generate a unique value from your client. The ClientToken value… |
| description | string | no | The description of the API MCP service |
| enableAssumeRole | string | no | Specifies whether to enable multi-account access |
| enableCustomVpcWhitelist | string | no | Specifies whether to enable a custom VPC whitelist. If this feature is not enabled, the account-level configuration is used |
| instructions | string | no | The MCP instructions that guide the large language model on how to use this MCP. The client must support the Instructions field in the MCP… |
| language | string | no | The document language of the API MCP service. You can select Chinese or English API documentation. Different languages may produce… |
| name | string | yes | The MCP SERVER name. The name must consist of lowercase letters (a-z) and digits (0-9), be 3 to 64 characters in length, cannot start with… |
| oauthClientId | string | no | The custom OAuth Client ID used when a custom OAuth configuration is selected |
| prompts | array | no | The list of prompt configurations |
| publicAccess | string | no | Specifies whether to enable public network access. Valid values: follow: follows the account-level public network access configuration.… |
| systemTools | array | no | The list of system tools |
| terraformTools | array | no | The list of Terraform tools |
| vpcWhitelists | array | no | The VPC whitelist that restricts the source VPCs when public network access is disabled. If this parameter is not set or is empty, no… |

### Creates an ApiMcpServerCore
`POST https://zieapi.vercel.app/v1/cloud:aliyun-openapiexplorer/create-api-mcp-server-core` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://openapi-mcp.ap-southeast-1.aliyuncs.com |
| assumeRoleName | string | no | The name of the RAM role to assume in the target account when performing cross-account operations with multi-account access enabled |
| assumeRoleOverridePolicy | string | no | The additional policy for role assumption when multi-account access is enabled. If this policy is specified, the permissions for role… |
| clientToken | string | no | The idempotence token |
| enableAssumeRole | string | no | Specifies whether to enable multi-account access |
| enableCustomVpcWhitelist | string | no | Specifies whether to enable a custom VPC whitelist. If this parameter is not enabled, the account-level configuration is used |
| oauthClientId | string | no | The custom OAuth Client ID used when a custom OAuth configuration is selected. `Only Web/Native applications are supported, and the OAuth… |
| publicAccessType | string | no | The public network access type: allow public access, disallow public access, or inherit account configuration. `public` (enabled),… |
| vpcWhitelists | array | no | The VPC whitelist entries. Each value is a source VPC ID |

### Deletes a single API MCP service
`POST https://zieapi.vercel.app/v1/cloud:aliyun-openapiexplorer/delete-api-mcp-server` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://openapi-mcp.ap-southeast-1.aliyuncs.com |
| clientToken | string | no | Ensures the idempotence of the request. Generate a parameter value from your client that is unique across different requests. ClientToken… |
| id | string | yes | The ID of the API MCP service |

### Deletes an ApiMcpServerCore
`POST https://zieapi.vercel.app/v1/cloud:aliyun-openapiexplorer/delete-api-mcp-server-core` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://openapi-mcp.ap-southeast-1.aliyuncs.com |
| clientToken | string | no | The unique identifier used to ensure request idempotence. When creating or updating a resource, if the same ClientToken is used for… |
| id | string | yes | The unique ID |

### Dynamically generates an Alibaba Cloud CLI command
`POST https://zieapi.vercel.app/v1/cloud:aliyun-openapiexplorer/generate-clicommand` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://openapi-mcp.ap-southeast-1.aliyuncs.com |
| product | string | yes | The product code. Call the GetRequestLog operation to obtain the product code from the response. Find the product code from the URL of the… |
| apiVersion | string | yes | The API version |
| api | string | yes | The API name |
| regionId | string | no | The region ID |
| apiParams | string | no | The request parameters (JSON-encoded) |
| jsonApiParams | string | no | The API input parameters in JSON format. This parameter has a lower priority than apiParams. If apiParams is set, this parameter does not… |
| aggregatePagination | string | no | Specifies whether to use the aggregation feature. If enabled, the CLI automatically reads full data in a paged manner and aggregates the… |

### Queries the metadata for an API operation of a cloud service
`GET https://zieapi.vercel.app/v1/cloud:aliyun-openapiexplorer/get-api-definition` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://openapi-mcp.ap-southeast-1.aliyuncs.com |
| product | string | yes | The product code. You can find it in two ways: Call the `GetRequestLog` operation. The product code will be included in the response data.… |
| apiVersion | string | yes | The API version |
| api | string | yes | The API name |

### Queries the details of an API MCP service
`GET https://zieapi.vercel.app/v1/cloud:aliyun-openapiexplorer/get-api-mcp-server` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://openapi-mcp.ap-southeast-1.aliyuncs.com |
| id | string | yes | The API MCP service ID |

### Queries an ApiMcpServerCore
`GET https://zieapi.vercel.app/v1/cloud:aliyun-openapiexplorer/get-api-mcp-server-core` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://openapi-mcp.ap-southeast-1.aliyuncs.com |
| id | string | yes | The unique ID |

### Queries the global API MCP Server configuration for a user. The configuration includes settings for public…
`GET https://zieapi.vercel.app/v1/cloud:aliyun-openapiexplorer/get-api-mcp-server-user-config` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://openapi-mcp.ap-southeast-1.aliyuncs.com |

### Retrieves SDK code examples
`POST https://zieapi.vercel.app/v1/cloud:aliyun-openapiexplorer/get-code-sample` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://openapi-mcp.ap-southeast-1.aliyuncs.com |
| apiName | string | yes | The OpenAPI name |
| apiVersion | string | no | The OpenAPI version |
| callType | string | no | The SDK invocation type. Valid values: typed: product-specific SDK pattern. generic: Common generalized invocation pattern. Default value:… |
| language | string | yes | The programming language for the code example |
| params | string | no | The JSON string of OpenAPI request parameters. The key is the parameter name and the value is the serialized parameter value |
| product | string | yes | The cloud service code |
| regionId | string | no | The region ID |

### Retrieves the corresponding solutions based on the provided error code
`GET https://zieapi.vercel.app/v1/cloud:aliyun-openapiexplorer/get-error-code-solutions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://openapi-mcp.ap-southeast-1.aliyuncs.com |
| errorCode | string | yes | The error code for which you want to query diagnostic solutions |
| errorMessage | string | no | The error message for which you want to query diagnostic solutions. This parameter must be used together with the errorCode parameter |
| product | string | no | The product CODE. Call the GetRequestLog operation to obtain the product CODE from the response. Find the product CODE from the OpenAPI… |
| acceptLanguage | string | no | The language of the diagnostic solutions to query. Chinese (zh-CN) and English (en-US) are supported. Not all diagnostic solutions have… |

### Queries the log details of an OpenAPI call made by the current account based on the Request ID returned by…
`GET https://zieapi.vercel.app/v1/cloud:aliyun-openapiexplorer/get-own-request-log` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://openapi-mcp.ap-southeast-1.aliyuncs.com |
| logRequestId | string | yes | The Request ID for which you want to query logs |

### Quries the endpoint information for a cloud service
`GET https://zieapi.vercel.app/v1/cloud:aliyun-openapiexplorer/get-product-endpoints` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://openapi-mcp.ap-southeast-1.aliyuncs.com |
| product | string | yes | The product code. You can find it in two ways: Call the `GetRequestLog` operation. The product code will be included in the response data.… |

### Queries the log details of a request by the Request ID returned by an API to troubleshoot issues
`GET https://zieapi.vercel.app/v1/cloud:aliyun-openapiexplorer/get-request-log` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://openapi-mcp.ap-southeast-1.aliyuncs.com |
| logRequestId | string | yes | The RequestId for which you want to query logs |

### Retrieves SDK information
`GET https://zieapi.vercel.app/v1/cloud:aliyun-openapiexplorer/get-sdk-dependencies` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://openapi-mcp.ap-southeast-1.aliyuncs.com |
| callType | string | no | The SDK call type. Valid values: typed: product-specific SDK mode. generic: Common generalized calls mode. Default value: typed |
| product | string | yes | The cloud product code |
| version | string | no | The OpenAPI version |
| language | string | yes | The SDK programming language, used to filter the returned SDK version information |

### Retrieves the OpenAPI metadata for a product
`GET https://zieapi.vercel.app/v1/cloud:aliyun-openapiexplorer/list-api-definitions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://openapi-mcp.ap-southeast-1.aliyuncs.com |
| product | string | yes | The product code. Call the GetRequestLog operation to obtain the product code from the response. Find the product code in the URL of the… |
| apiVersion | string | yes | The version of the API |

### Lists ApiMcpServerCore resources
`GET https://zieapi.vercel.app/v1/cloud:aliyun-openapiexplorer/list-api-mcp-server-cores` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://openapi-mcp.ap-southeast-1.aliyuncs.com |
| id | string | no | The unique ID |
| nextToken | string | no | The pagination token. A non-empty value indicates that more data is available |
| maxResults | integer | no | The maximum number of entries per page for paging queries. Maximum value: 100. Default value: 20 |
| skip | integer | no | The number of data entries to skip |

### Queries the system tools supported by the MCP service
`GET https://zieapi.vercel.app/v1/cloud:aliyun-openapiexplorer/list-api-mcp-server-system-tools` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://openapi-mcp.ap-southeast-1.aliyuncs.com |
| maxResults | integer | no | The maximum number of entries per page for a paged query. Maximum value: 100. Default value: 20 |
| skip | integer | no | The number of data entries to skip |
| nextToken | string | no | The token for the next query. Set this parameter to the NextToken value returned by the previous API call. You do not need to specify this… |

### Queries the list of all API MCP servers under the parent account
`GET https://zieapi.vercel.app/v1/cloud:aliyun-openapiexplorer/list-api-mcp-servers` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://openapi-mcp.ap-southeast-1.aliyuncs.com |
| id | string | no | The ID of the API MCP service |
| nextToken | string | no | The token for the next query. Set this parameter to the NextToken value returned by the previous API call |
| maxResults | integer | no | The maximum number of entries per page in a paged query. Maximum value: 100. Default value: 20 |
| skip | integer | no | The number of data entries to skip |
| description | string | no | The description of the API MCP service |
| language | string | no | The documentation language of the API MCP service. Chinese or English API documentation can be selected. Different language prompts may… |
| createTime | string | no | The filter condition for the creation time of the API MCP server. The time is in UTC and follows the ISO 8601 standard in the format of… |
| updateTime | string | no | The filter condition for the update time of the API MCP server. The time is in UTC and follows the ISO 8601 standard in the format of… |
| sourceType | string | no | The type of the API MCP service |
| keyword | string | no | The search keyword. Fuzzy search by API name or exact search by API ID is supported |

### Queries all Alibaba Cloud services, with support for filtering by keyword
`GET https://zieapi.vercel.app/v1/cloud:aliyun-openapiexplorer/list-products` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://openapi-mcp.ap-southeast-1.aliyuncs.com |
| filter | string | no | The filter condition for the query. If not specified, all Alibaba Cloud services are returned |

### Modifies an API MCP service
`POST https://zieapi.vercel.app/v1/cloud:aliyun-openapiexplorer/update-api-mcp-server` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://openapi-mcp.ap-southeast-1.aliyuncs.com |
| clientToken | string | no | The client token that is used to ensure the idempotence of the request. You can use the client to generate the token, but you must make… |
| id | string | yes | The ID of the API MCP service |
| additionalApiDescriptions | array | no | The list of supplementary API descriptions |
| apis | array | no | The list of APIs to modify |
| assumeRoleExtraPolicy | string | no | The additional policy for role assumption when multi-account access is enabled. If this policy is specified, the permissions for role… |
| assumeRoleName | string | no | The name of the RAM role to assume in the target account when performing cross-account operations with multi-account access enabled |
| description | string | no | The description of the API MCP server |
| enableAssumeRole | string | no | Specifies whether to enable multi-account access |
| enableCustomVpcWhitelist | string | no | Specifies whether to enable a custom VPC whitelist. If not enabled, the account-level configuration is used |
| instructions | string | no | The MCP instructions that guide the large language model on how to use this MCP. The client must support the Instructions field in the MCP… |
| language | string | no | The documentation language of the API MCP service. You can select Chinese or English API documentation. Different languages may produce… |
| oauthClientId | string | no | The custom OAuth Client ID used when a custom OAuth configuration is selected |
| prompts | array | no | The list of prompt configurations |
| publicAccess | string | no | Specifies whether to enable public network access. Valid values: follow: follows the account-level public network access configuration.… |
| systemTools | array | no | The list of system tools |
| terraformTools | array | no | The list of Terraform tools |
| vpcWhitelists | array | no | The VPC whitelist that restricts the source when public network access is disabled. If not set or empty, no source restriction is applied |

### Updates an ApiMcpServerCore
`POST https://zieapi.vercel.app/v1/cloud:aliyun-openapiexplorer/update-api-mcp-server-core` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://openapi-mcp.ap-southeast-1.aliyuncs.com |
| clientToken | string | no | The unique identifier used to ensure request idempotence. When creating or updating a resource, if you send multiple requests with the… |
| id | string | yes | The ID of the API MCP Core service that was successfully created |
| assumeRoleName | string | no | The name of the RAM role to assume in the target account when performing cross-account operations with multi-account access enabled |
| assumeRoleOverridePolicy | string | no | The AssumeRole override policy |
| enableAssumeRole | string | no | Specifies whether to enable multi-account access |
| enableCustomVpcWhitelist | string | no | Specifies whether to enable a custom VPC whitelist. If this feature is not enabled, the account-level configuration is used |
| oauthClientId | string | no | The custom OAuth Client ID when a custom OAuth configuration is selected. `Only Web/Native applications are supported, and the OAuth scope… |
| publicAccessType | string | no | The public network access type: allow public access, disallow public access, or inherit account configuration. `public` (enabled),… |
| vpcWhitelists | array | no | The VPC whitelist entries. Each value is a source VPC ID |

### Modifies the global API MCP Server configuration for a user
`POST https://zieapi.vercel.app/v1/cloud:aliyun-openapiexplorer/update-api-mcp-server-user-config` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://openapi-mcp.ap-southeast-1.aliyuncs.com |
| enablePublicAccess | string | no | Specifies whether to enable public network access for all API MCP Servers (including system MCP Servers) under the account. Default value:… |
| vpcWhitelists | array | no | The VPC whitelist that restricts access sources after public network access is disabled. If not specified or empty, no source restriction… |

### version
`POST https://zieapi.vercel.app/v1/cloud:aliyun-openapiexplorer/version` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://openapi-mcp.ap-southeast-1.aliyuncs.com |

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:aliyun-openapiexplorer/api-mcp-server-validate-hcl" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Alibaba Cloud OpenAPI Portal Services API?
Create a free Apizie key, then send POST https://zieapi.vercel.app/v1/cloud:aliyun-openapiexplorer/api-mcp-server-validate-hcl with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Alibaba Cloud OpenAPI Portal Services API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Alibaba Cloud OpenAPI Portal Services itself also needs your own key from aliyuncs.com.

### Can AI agents use the Alibaba Cloud OpenAPI Portal Services API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:aliyun-openapiexplorer.

### What is the status of the Alibaba Cloud OpenAPI Portal Services API?
Needs your own provider key (bring your own key)
