1、获取API令牌

通过该接口，用户可以获取接口调用所需的令牌，其他的接口调用都需要该令牌

请求说明

POST https://kbaas.api.ksyun.com/v1/user/login

请求示例

curl -X POST \
    https://kbaas.api.ksyun.com/v1/user/login \
    -H 'Content-Type: application/json' \
    -d '{
        "userName": "admin",
        "password": "pass"
    }'

响应说明

返回信息的示例如下：

{
   "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjVmZWFmMGIwLTYyNmQtMTFlOC1hNkZW1qmLwAXkji.PMh9OXi1sWIgFjGCwsw48SAE"
}

2、查看区块链详情

通过调用该接口，用户可以获取某条区块链的详细信息

请求说明

GET https://kbaas.api.ksyun.com/v1/consortium-chain/<your chain id>

请求示例

curl -X GET \
    https://kbaas.api.ksyun.com/v1/consortium-chain/5b4160c129f8af0429829896 \
    -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6ICJ9.eyJpZCI6IjVmZWFmMGIwLTYyNmQtMTFldAemlnZ3VyOTQxM30.Sm-K3nqIFuEjCmQ8'

响应说明

返回信息的示例如下：

{
    "id": "5b4160c129f8af0429829896",
    "chainName": "fabric",
    "userId": "5feaf0b0-626d-11ab-a5ad-d9c6a1df8cde",
    "userName": "admin",
    "type": "fabric",
    "size": 1,
    "consensusPlugin": "solo",
    "channelName": "mychannel",
    "status": "running",
    "peerNumber": 1,
    "blockNumber": 1,
    "transactions": 0,
    "chainCodeNumber": 0,
    "containers": [
        {
        "id": "af6a7abcbaf6935555cd511d4cbcdc29c30c577d8cd1deeeaeceb60a9cef8754",
        "name": "orderer.example.com"
        },
        {
        "id": "008528e8b4caf2a7a85840fd06b6e50b96884c957569ebdf4bf46f0adca2c8ad",
        "name": "ca.peerOrg1"
        },
        {
        "id": "95aee5fce0d1e38f8dfa3e989451656856ef47f876d8dd2de62e6374a261484a",
        "name": "peer0.org1.example.com"
        }
    ],
    "createTime": "2018-07-08T00:54:27.869Z"
}

3、查看区块列表

通过调用该接口，用户可以查看某条链上生成的区块列表。

请求说明

GET https://kbaas.api.ksyun.com/v1/consortium-chain/<your chain id>/blocks?limit=<limit>&since_block_number=<start block number>

请求示例

curl -X GET \
    https://kbaas.api.ksyun.com/v1/consortium-chain/5b4160c129f8af0429829896/blocks?limit=1&since_block_number=1 \
    -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6ICJ9.eyJpZCI6IjVmZWFmMGIwLTYyNmQtMTFldAemlnZ3VyOTQxM30.Sm-K3nqIFuEjCmQ8'

响应说明 返回信息的示例如下：

{
   "blocks": [
       {
           "no": 1,
           "blockNumber": 1,
           "hash": "3d2da2171aaa928cada5c8295357acb6153a2aa7e68ee4c080956cedd19942d5",
           "transactions": 1,
           "timestamp": "2018-07-08T12:45:49.000Z"
       }
   ],
   "limit": 1,
   "size": 1,
   "startBlockNumber": 1,
   "paging": {
       "previous": "/v1/consortium-chain/5b4160c129f8af0429829896/blocks?limit=1&since_block_number=2",
       "next": "/v1/consortium-chain/5b4160c129f8af0429829896/blocks?limit=1&since_block_number=0"
   }
}

4、查看区块详情

通过调用该接口，用户可以查看某个区块的详细信息。

请求说明

GET https://kbaas.api.ksyun.com/v1/consortium-chain/<your chain id>/block/<block number>

请求示例

curl -X GET \
        https://api-baas.zhigui.com/v1/consortium-chain/5b4160c129f8af0429829896/block/1 \
        -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6ICJ9.eyJpZCI6IjVmZWFmMGIwLTYyNmQtMTFldAemlnZ3VyOTQxM30.Sm-K3nqIFuEjCmQ8'

响应说明

返回信息的示例如下：

{
   "txList": [
       {
           "id": "0c87cbbd34d586c0f29ad5325035acab6afc50969e4ce59febbb12dbfce2e4a8",
           "timestamp": "2018-07-08T12:45:49.000Z",
           "channelId": "mychannel"
       }
   ],
   "blockHeight": 1,
   "previousHash": "6f5956335fdbaa86beb216104500c8122174252f3ceb24b917dca981466432c9",
   "dataHash": "3d2da2171aaa928cada5c8295357acb6153a2aa7e68ee4c080956cedd19942d5"
}

5、查看交易列表

通过调用该接口，用户可以查看某条链上生成的交易列表。

请求说明

GET https://kbaas.api.ksyun.com/v1/consortium-chain/<your chain id>/transactions?limit=<limit>&since_block_number=<start block number>&since_tx_index=<start transaction index>

请求示例

curl -X GET \
    'https://kbaas.api.ksyun.com/v1/consortium-chain/5b4160c129f8af0429829896/transactions?limit=1&since_block_number=1&since_tx_index=0' \
    -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6ICJ9.eyJpZCI6IjVmZWFmMGIwLTYyNmQtMTFldAemlnZ3VyOTQxM30.Sm-K3nqIFuEjCmQ8' \

响应说明

返回信息的示例如下：

{
   "transactions": [
       {
           "no": 1,
           "txId": "0c87cbbd34d586c0f29ad5325035acab6afc50969e4ce59febbb12dbfce2e4a8",
           "timestamp": "2018-07-08T12:45:49.000Z"
       }
   ],
   "limit": 1,
   "size": 1,
   "startBlockNumber": 1,
   "paging": {
       "previous": "/v1/consortium-chain/5b4160c129f8af0429829896/transactions?limit=1&since_block_number=2&since_tx_index=0",
       "next": "/v1/consortium-chain/5b4160c129f8af0429829896/transactions?limit=1&since_block_number=0&since_tx_index=0"
   }
}

6、查看交易详情

通过调用该接口，用户可以查看某个交易的详细信息。

请求说明

GET https://kbaas.api.ksyun.com/v1/consortium-chain/<your chain id>/transaction/<transaction hash>

请求示例

curl -X GET \
    https://kbaas.api.ksyun.com/v1/consortium-chain/5b4160c129f8af0429829896/transaction/0c87cbbd34d586c0f29ad5325035acab6afc50969e4ce59febbb12dbfce2e4a8 \
    -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6ICJ9.eyJpZCI6IjVmZWFmMGIwLTYyNmQtMTFldAemlnZ3VyOTQxM30.Sm-K3nqIFuEjCmQ8'

响应说明

返回信息的示例如下：

{
   "validationCode": 0,
   "type": "GOLANG",
   "name": "lscc",
   "fee": 0,
   "blockHash": "",
   "endorser": "Org1MSP",
   "endorserId": "-----BEGIN -----\nMIICGDCCAb+gAwIBAgIQPcMFFEB/vq6mEL6vXV7aUTAKBggqhkjOPQQDAjBzMQsw\nCQYDVQQGEwJVUzETMBEGA1UECBMKQ2FsaWZvcm5pYTEWMBQGA1UEBxMNU2FuIEZy\nYW5jaXNjbzEZMBcGA1UEChMQb3JnMS5leGFtcGxlLmNvbTEcMBoGA1UEAxMTY2Eu\nb3JnMS5leGFtcGxlLmNvbTAeFw0xNzA2MjMxMjMzMTlaFw0yNzA2MjExMjMzMTla\nMFsxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpDYWxpZm9ybmlhMRYwFAYDVQQHEw1T\nYW4gRnJhbmNpc2NvMR8wHQYDVQQDExZwZWVyMC5vcmcxLmV4YW1wbGUuY29tMFkw\nEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEzS9k2gCKHcat8Wj4T2nB1uyC8R2zg3um\nxdTL7nmgFWp0uyCCbQQxD/VS+8R/3DNvEFkvzhcjc9NU/nRqMirpLqNNMEswDgYD\nVR0PAQH/BAQDAgeAMAwGA1UdEwEB/wQCMAAwKwYDVR0jBCQwIoAgDnKSJOiz8xeE\nyKk8W4729MHJHZ5uV3xFwzFjYJ/kABEwCgYIKoZIzj0EAwIDRwAwRAIgHBdxbHUG\nrFUzKPX9UmmN3SwigWcRUREUy/GTb3hDIAsCIEF1BxTqv8ilQYE8ql0wJL4mTber\nHE6DFYvvBCUnicUh\n-----END -----\n",
   "sender": "",
   "args": [
       "deploy",
       "mychannel",
       "\n&\b\u0001\u0012\f\u0012\u0005trans\u001a\u00031.0\u001a\u0014\n\u0004init\n\u0001a\n\u000210\n\u0001b\n\u000210",
       "\u0012\f\u0012\n\b\u0001\u0012\u0002\b\u0000\u0012\u0002\b\u0001\u001a\u000b\u0012\t\n\u0007Org1MSP\u001a\u000b\u0012\t\n\u0007Org2MSP"
   ]
}

7、查看已安装或部署的链码列表

通过调用该接口，用户可以查看某条链上已经安装，部署的链码列表。

请求说明

GET https://kbaas.api.ksyun.com/v1/consortium-chain/<your chain id>/chaincode/list

请求示例

curl -X GET \
        https://kbaas.api.ksyun.com/v1/consortium-chain/5b4160c129f8af0429829896/chaincode/list \
        -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6ICJ9.eyJpZCI6IjVmZWFmMGIwLTYyNmQtMTFldAemlnZ3VyOTQxM30.Sm-K3nqIFuEjCmQ8'

响应说明

返回信息的示例如下：

[
   {
       "id": "5b420771b162ba48b3ebe613",
       "userId": "5feadbb0-626d-11e8-a54b-d9c6a1ab8cde",
       "userName": "admin",
       "displayName": "资产转移合约",
       "name": "trans",
       "version": "1.0",
       "description": "资产转移示例合约（trans）为Fabric官方示例合约（chaincode_ example02），模拟实现了不同实体（Entity）间资产的初始化、删除和转移功能。",
       "defaultParameters": [],
       "chainName": "fa",
       "chainType": "fabric",
       "chainSize": 1,
       "status": "instantiated",
       "instantiateTime": "2018-07-08T12:45:52.051Z"
   }
]

8、调用链码函数

通过调用该接口，用户可以调用链码上的函数。

请求说明

POST https://kbaas.api.ksyun.com/v1/consortium-chain/<your chain id>/chaincode/invoke

请求示例

curl -X POST \
    https://kbaas.api.ksyun.com/v1/consortium-chain/5b4160c129f8af0429829896/chaincode/invoke \
    -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6ICJ9.eyJpZCI6IjVmZWFmMGIwLTYyNmQtMTFldAemlnZ3VyOTQxM30.Sm-K3nqIFuEjCmQ8' \
    -H 'Content-Type: application/json' \
    -d '{
        "name": "trans",
        "version": "1.0",
        "func": "invoke",
        "parameter": [
            "a",
            "b",
            "4"
        ]
    }'

响应说明

返回信息的示例如下：

{
   "message": "4ca212b82d60f52ca16add14bf68d55603af2a9aa6980c404c1579170b470453"
}

9、查询链码

通过该接口，用户可以调用链码上的查询函数。

请求说明

POST https://kbaas.api.ksyun.com/v1/consortium-chain/<your chain id>/chaincode/query

请求示例

curl -X POST \
    https://api-baas.zhigui.com/v1/consortium-chain/5b4160c129f8af0429829896/chaincode/query \
    -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6ICJ9.eyJpZCI6IjVmZWFmMGIwLTYyNmQtMTFldAemlnZ3VyOTQxM30.Sm-K3nqIFuEjCmQ8' \
    -H 'Content-Type: application/json' \
    -d '{
        "name": "trans",
        "version": "1.0",
        "func": "query",
        "parameter": [
        "a"
        ]
    }'

响应说明

返回信息的示例如下：

{
   "success": true,
   "payloads": [
       5
   ]
}

10、查看账户列表

通过该接口，用户可以查看账户列表。

请求说明

GET https://kbaas.api.ksyun.com/v1/account/list?chainId=<your chain id>

请求示例

curl -X GET \
    'https://kbaas.api.ksyun.com/v1/account/list?chainId=5b42228729f8af0429829942' \
    -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6ICJ9.eyJpZCI6IjVmZWFmMGIwLTYyNmQtMTFldAemlnZ3VyOTQxM30.Sm-K3nqIFuEjCmQ8'

响应说明

返回信息的示例如下：

[
   {
       "id": "5b42229129f8af0429829943",
       "userId": "5fabcdb0-626d-11e8-a54b-d9c6a1e28bde",
       "userName": "admin",
       "address": "i99a321841a0cac942768c3abcded66050037f3"
   }
]

11、添加账户

通过该接口，用户可以新加账户。

请求说明

POST https://kbaas.api.ksyun.com/v1/account/add?chainId=<your chain id>

请求示例

curl -X POST \
    'https://kbaas.api.ksyun.com/v1/account/add?chainId=5b42228729f8af0429829942' \
    -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6ICJ9.eyJpZCI6IjVmZWFmMGIwLTYyNmQtMTFldAemlnZ3VyOTQxM30.Sm-K3nqIFuEjCmQ8'

响应说明

返回信息的示例如下：

{
   "id": "5b42268f29f8af042982994b",
   "userId": "5fabcdb0-626d-11e8-a54b-d9c6a1e28bde",
   "userName": "admin",
   "address": "idc49eb42e271646dc0545623f73cf91221216b78"
}

12、删除账户

通过该接口，用户可以删除账户。

请求说明

DELETE https://kbaas.api.ksyun.com/v1/account/<account address>?chainId=<your chain id>

请求示例

curl -X DELETE \
    'https://kbaas.api.ksyun.com/v1/account/idc49eb42e271646dc0545623f73cf91221216b78?chainId=5b42228729f8af0429829942' \
    -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6ICJ9.eyJpZCI6IjVmZWFmMGIwLTYyNmQtMTFldAemlnZ3VyOTQxM30.Sm-K3nqIFuEjCmQ8'

响应说明

返回的信息：

Status: 204 Not Content

13、查看账户资产列表

通过该接口，用户可以查看某账户资产列表。

请求说明

GET https://kbaas.api.ksyun.com/v1/account/<account address>/assets?chainId=<your chain id>

请求示例

curl -X GET \
    'https://kbaas.api.ksyun.com/v1/account/i99a321841a0cac942768c3f0cac28866050037f3/assets?chainId=5b42228729f8af0429829942' \
    -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6ICJ9.eyJpZCI6IjVmZWFmMGIwLTYyNmQtMTFldAemlnZ3VyOTQxM30.Sm-K3nqIFuEjCmQ8'

响应说明

返回的信息：

[
   {
       "name": "ZIG",
       "count": 100000000000,
       "decimal": 2,
       "step": "0.01"
   }
]

14、账户资产转账

通过该接口，用户可以进行账户资产的转账。

请求说明

POST https://kbaas.api.ksyun.com/v1/account/<account address>/assets/transfer?chainId=<your chain id>

请求示例

curl -X POST \
    'https://kbaas.api.ksyun.com/v1/account/i99a321841a0cac942768c3f0cac28866050037f3/assets/transfer?chainId=5b42228729f8af0429829942' \
    -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6ICJ9.eyJpZCI6IjVmZWFmMGIwLTYyNmQtMTFldAemlnZ3VyOTQxM30.Sm-K3nqIFuEjCmQ8' \
    -H 'Content-Type: application/json' \
    -d '{
        "token": "ZIG",
        "count": "10",
        "decimal": "2",
        "toAddress": "i4357f803d9c3d89b352bfdb833986cb121edaa85"
    }'

响应说明

返回的信息：

{
   "message": "c869220472a310a2c3e5868d905fa7aa8ac8989187eab1ca614ce7fd316605a0"
}

15 、看通证列表

通过该接口，用户可以查看当前发行的通证列表。

请求说明

GET https://kbaas.api.ksyun.com/v1/token/list?chainId=<your chain id>

请求示例

curl -X GET \
    'https://kbaas.api.ksyun.com/v1/token/list?chainId=5b42228729f8af0429829942' \
    -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6ICJ9.eyJpZCI6IjVmZWFmMGIwLTYyNmQtMTFldAemlnZ3VyOTQxM30.Sm-K3nqIFuEjCmQ8'

响应说明

返回的信息：

[
   {
       "id": "5b42229129f8af0429829944",
       "userId": "5feaf123-626d-11e8-a54b-d9c6abcdedde",
       "userName": "admin",
       "name": "ZIG",
       "totalSupply": "100000000000.00",
       "decimal": 2,
       "issueAddress": "i99a321841a0cac942768c3f0cac28866050037f3",
       "issueTime": "2018-07-08T14:41:21.700Z"
   }
]

16、发行通证

通过该接口，用户可以发行新通证。

请求说明

POST https://kbaas.api.ksyun.com/v1/token/issue?chainId=<your chain id>

请求示例

curl -X POST \
    'https://kbaas.api.ksyun.com/v1/token/issue?chainId=5b42228729f8af0429829942' \
    -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6ICJ9.eyJpZCI6IjVmZWFmMGIwLTYyNmQtMTFldAemlnZ3VyOTQxM30.Sm-K3nqIFuEjCmQ8' \
    -H 'Content-Type: application/json' \
    -d '{
        "tokenName": "LXC",
        "totalSupply": "10000000000",
        "decimal": "2",
        "address": "i4357f803d9c3d89b352bfdb833986cb121edaa85"
    }'

响应说明

返回的信息：

{
   "message": "9639c8feff8f7bfd94881a1406ffedad292261a8d104ed8ed390303dccce5bed"
}

产品文档

产品简介

操作指南

Zig-Ledger

Hyperledger Fabric

Ethereum

IPFS

开发指南

Zig-Ledger

Hyperledger Fabric

Ethereum

IPFS

合约中心

Zig-Ledger

Hyperledger Fabric

Ethereum

总览

产品简介下载pdf

操作指南下载pdf

开发指南下载pdf

合约中心下载pdf

金山云，开启您的云计算之旅