5.4.3.9 Get transaction data API
This interface can be used by off-BSN systems to obtain transaction information based on the transaction ID and then returns the string of the transaction information by base64 encryption.
1. Interface address: https://PCNGatewayAddress/api/fabric/v1/node/getTransdata
2. Call method: POST
3. Signature algorithm: required and refer to Section 5.4.3.1
4. Call parameters
| No. | Field name | Field | Type | Required | Remarks |
|---|---|---|---|---|---|
| 1 | Header | header | Map | Y | |
| 2 | Body | body | Map | Y | |
| 3 | Signature Value | mac | String | Y | |
| Header | |||||
| 1 | user unique ID | userCode | String | Y | |
| 2 | DApp unique ID | appCode | String | Y | |
| Body | |||||
| 1 | Transaction Id | txId | String | Y |
Example:
{"header":{"userCode":"USER0001202004151958010871292","appCode":"app0001202004161020152918451","tId":""},"mac":"MEUCIQDIbcNl+C1iBbXWGW3qjhf80IRgCgvJuyxx0WXU2vn2TAIgZgA020L2aXBtrdLsYEkYPyiOJ9+AFrXOEwfuzy8B4bE=","body":{"txId":"c3c6523958c3811192b8d358dd2617f1b14cb661de6b022c1a822269e8a8c48d"}}
5. Response parameters
| No. | Field name | Field | Type | Required | Remarks |
|---|---|---|---|---|---|
| 1 | header | header | Map | Y | |
| 2 | body | body | Map | Y | |
| 3 | signature value | mac | String | Y | |
| Header | |||||
| 1 | Response ID | code | int | Y | 0: authentication successful -1: authentication failed |
| 2 | Response Message | msg | String | N | if code=0 then can be null |
| Body | |||||
| 1 | Transaction Id | txId | String | Y | |
| 2 | Transaction data | transData | String | Y | String generated by base64 calculation |
Example:
{{
"header": {
"code": 0,
"msg": "success"
},
"mac": "MEUCIQDI63PUa4WjE01S4cdYy5spMRSYPLFzEvYGKHszTSFxtAIgND/A/Cky9XDpHLNKQzOvgyf1nb6edVy3JQisBn7OuIM=",
"body": {
"txId": "b1b2ef26cff816dce49a40be3527092a2b0d43d244d57611bb2b95a05c063feb",
"transData": "CtYgCosgCrIKCpgBCAMa........................."
}
}