# Tencent Cloud Blockchain as a Service API

> Tencent Cloud Blockchain as a Service API on Apizie: 24 endpoints (Apply Chain Maker Batch User Cert, Apply User Cert, Describe Fabric Block, Describe Fabric Transaction, …) 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://apizie.tech/v1/cloud:tencent-tbaas/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:tencent-tbaas`
- Category: Cloud
- Status: byok
- Source: https://www.tencentcloud.com/document/api
- Page: https://apizie.tech/api/cloud/tencent-tbaas
- OpenAPI: https://apizie.tech/api/cloud/tencent-tbaas/openapi.json

Tencent Cloud API 3.0 for Blockchain as a Service (tbaas). Every call is signed with TC3-HMAC-SHA256 using your SecretId and SecretKey.

## Endpoints

### Apply Chain Maker Batch User Cert
`POST https://apizie.tech/v1/cloud:tencent-tbaas/apply-chain-maker-batch-user-cert` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ClusterId | string | yes |  |
| SignUserCsrList | array | yes |  |

### Apply User Cert
`POST https://apizie.tech/v1/cloud:tencent-tbaas/apply-user-cert` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Module | string | yes |  |
| Operation | string | yes |  |
| ClusterId | string | yes |  |
| GroupName | string | yes |  |
| UserIdentity | string | yes |  |
| Applicant | string | yes |  |
| IdentityNum | string | yes |  |
| CsrData | string | yes |  |
| Notes | string | no |  |

### Describe Fabric Block
`POST https://apizie.tech/v1/cloud:tencent-tbaas/describe-fabric-block` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ClusterId | string | yes |  |
| ChannelId | string | yes |  |
| BlockHeight | integer | yes |  |

### Describe Fabric Transaction
`POST https://apizie.tech/v1/cloud:tencent-tbaas/describe-fabric-transaction` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ClusterId | string | yes |  |
| ChannelId | string | yes |  |
| TxId | string | yes |  |

### Download User Cert
`POST https://apizie.tech/v1/cloud:tencent-tbaas/download-user-cert` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Module | string | yes |  |
| Operation | string | yes |  |
| CertId | integer | yes |  |
| CertDn | string | yes |  |
| ClusterId | string | yes |  |
| GroupName | string | yes |  |

### Get Block List
`POST https://apizie.tech/v1/cloud:tencent-tbaas/get-block-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Module | string | yes |  |
| Operation | string | yes |  |
| ChannelId | integer | yes |  |
| GroupId | integer | yes |  |
| ChannelName | string | yes |  |
| GroupName | string | yes |  |
| ClusterId | string | yes |  |
| Offset | integer | no |  |
| Limit | integer | no |  |

### Get Block Transaction List For User
`POST https://apizie.tech/v1/cloud:tencent-tbaas/get-block-transaction-list-for-user` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Module | string | yes |  |
| Operation | string | yes |  |
| ClusterId | string | yes |  |
| GroupName | string | yes |  |
| ChannelName | string | yes |  |
| BlockId | integer | yes |  |
| Offset | integer | no |  |
| Limit | integer | no |  |

### Get Cluster Summary
`POST https://apizie.tech/v1/cloud:tencent-tbaas/get-cluster-summary` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Module | string | yes |  |
| Operation | string | yes |  |
| ClusterId | string | yes |  |
| GroupId | integer | yes |  |
| GroupName | string | yes |  |

### Get Invoke Tx
`POST https://apizie.tech/v1/cloud:tencent-tbaas/get-invoke-tx` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Module | string | yes |  |
| Operation | string | yes |  |
| ClusterId | string | yes |  |
| ChannelName | string | yes |  |
| PeerName | string | yes |  |
| PeerGroup | string | yes |  |
| TxId | string | yes |  |
| GroupName | string | yes |  |

### Get Latest Transaction List
`POST https://apizie.tech/v1/cloud:tencent-tbaas/get-latest-transaction-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Module | string | yes |  |
| Operation | string | yes |  |
| GroupId | integer | yes |  |
| ChannelId | integer | yes |  |
| LatestBlockNumber | integer | yes |  |
| GroupName | string | yes |  |
| ChannelName | string | yes |  |
| ClusterId | string | yes |  |
| Offset | integer | no |  |
| Limit | integer | no |  |

### Get Transaction Detail For User
`POST https://apizie.tech/v1/cloud:tencent-tbaas/get-transaction-detail-for-user` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Module | string | yes |  |
| Operation | string | yes |  |
| ClusterId | string | yes |  |
| GroupName | string | yes |  |
| ChannelName | string | yes |  |
| BlockId | integer | yes |  |
| TransactionId | string | yes |  |

### Invoke
`POST https://apizie.tech/v1/cloud:tencent-tbaas/invoke` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Module | string | yes |  |
| Operation | string | yes |  |
| ClusterId | string | yes |  |
| ChaincodeName | string | yes |  |
| ChannelName | string | yes |  |
| Peers | array | yes |  |
| FuncName | string | yes |  |
| GroupName | string | yes |  |
| Args | array | no |  |
| AsyncFlag | integer | no |  |

### Invoke Chain Maker Contract
`POST https://apizie.tech/v1/cloud:tencent-tbaas/invoke-chain-maker-contract` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ClusterId | string | yes |  |
| ChainId | string | yes |  |
| ContractName | string | yes |  |
| FuncName | string | yes |  |
| FuncParam | string | no |  |
| AsyncFlag | integer | no |  |

### Invoke Chain Maker Demo Contract
`POST https://apizie.tech/v1/cloud:tencent-tbaas/invoke-chain-maker-demo-contract` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ClusterId | string | yes |  |
| ChainId | string | yes |  |
| ContractName | string | yes |  |
| FuncName | string | yes |  |
| FuncParam | string | no |  |
| AsyncFlag | integer | no |  |

### Invoke Fabric Chaincode
`POST https://apizie.tech/v1/cloud:tencent-tbaas/invoke-fabric-chaincode` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ClusterId | string | yes |  |
| ChannelId | string | yes |  |
| ChaincodeName | string | yes |  |
| FuncName | string | yes |  |
| FuncParam | array | no |  |
| WithAsyncResult | boolean | no |  |

### Query
`POST https://apizie.tech/v1/cloud:tencent-tbaas/query` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Module | string | yes |  |
| Operation | string | yes |  |
| ClusterId | string | yes |  |
| ChaincodeName | string | yes |  |
| ChannelName | string | yes |  |
| Peers | array | yes |  |
| FuncName | string | yes |  |
| GroupName | string | yes |  |
| Args | array | no |  |

### Query Chain Maker Block Transaction
`POST https://apizie.tech/v1/cloud:tencent-tbaas/query-chain-maker-block-transaction` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ClusterId | string | yes |  |
| ChainId | string | yes |  |
| BlockHeight | integer | yes |  |

### Query Chain Maker Contract
`POST https://apizie.tech/v1/cloud:tencent-tbaas/query-chain-maker-contract` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ClusterId | string | yes |  |
| ChainId | string | yes |  |
| ContractName | string | yes |  |
| FuncName | string | yes |  |
| FuncParam | string | no |  |

### Query Chain Maker Demo Block Transaction
`POST https://apizie.tech/v1/cloud:tencent-tbaas/query-chain-maker-demo-block-transaction` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ClusterId | string | yes |  |
| ChainId | string | yes |  |
| BlockHeight | integer | yes |  |

### Query Chain Maker Demo Contract
`POST https://apizie.tech/v1/cloud:tencent-tbaas/query-chain-maker-demo-contract` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ClusterId | string | yes |  |
| ChainId | string | yes |  |
| ContractName | string | yes |  |
| FuncName | string | yes |  |
| FuncParam | string | no |  |

### Query Chain Maker Demo Transaction
`POST https://apizie.tech/v1/cloud:tencent-tbaas/query-chain-maker-demo-transaction` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ClusterId | string | yes |  |
| ChainId | string | yes |  |
| TxID | string | yes |  |

### Query Chain Maker Transaction
`POST https://apizie.tech/v1/cloud:tencent-tbaas/query-chain-maker-transaction` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ClusterId | string | yes |  |
| ChainId | string | yes |  |
| TxID | string | yes |  |

### Query Fabric Chaincode
`POST https://apizie.tech/v1/cloud:tencent-tbaas/query-fabric-chaincode` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ClusterId | string | yes |  |
| ChannelId | string | yes |  |
| ChaincodeName | string | yes |  |
| FuncName | string | yes |  |
| FuncParam | array | no |  |

### Srv Invoke
`POST https://apizie.tech/v1/cloud:tencent-tbaas/srv-invoke` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Service | string | yes |  |
| Method | string | yes |  |
| Param | string | yes |  |

## Example
```
curl "https://apizie.tech/v1/cloud:tencent-tbaas/apply-chain-maker-batch-user-cert" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Tencent Cloud Blockchain as a Service API?
Create a free Apizie key, then send POST https://apizie.tech/v1/cloud:tencent-tbaas/apply-chain-maker-batch-user-cert with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Tencent Cloud Blockchain as a Service API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Tencent Cloud Blockchain as a Service itself also needs your own key from tencentcloudapi.com.

### Can AI agents use the Tencent Cloud Blockchain as a Service API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:tencent-tbaas.

### What is the status of the Tencent Cloud Blockchain as a Service API?
Needs your own provider key (bring your own key)