mirror of https://github.com/hyperledger/fabric-samples.git synced 2026-06-17 15:35:09 +00:00

History

Mark S. Lewis 5e91d365d4 Update to Go 1.23 Go 1.24 was released on 2025-02-11. At this point Go 1.22 become an unsupported Go runtime. Signed-off-by: Mark S. Lewis <Mark.S.Lewis@outlook.com>		2025-02-12 08:34:17 -05:00
..
web	Explicitly specify hash in client applications	2024-10-07 12:25:40 -04:00
.gitignore	REST api added for asset transfer in Golang (#836 )	2022-12-14 09:16:09 +01:00
go.mod	Update to Go 1.23	2025-02-12 08:34:17 -05:00
go.sum	Simplify Java client error-handling example	2024-10-24 23:45:04 -04:00
main.go	Update Go gRPC dependency	2024-04-24 16:24:37 +09:00
README.md	REST api added for asset transfer in Golang (#836 )	2022-12-14 09:16:09 +01:00

README.md

Asset Transfer REST API Sample

This is a simple REST server written in golang with endpoints for chaincode invoke and query.

Usage

Setup fabric test network and deploy the asset transfer chaincode by following this instructions.
cd into rest-api-go directory
Download required dependencies using go mod download
Run go run main.go to run the REST server

Sending Requests

Invoke endpoint accepts POST requests with chaincode function and arguments. Query endpoint accepts get requests with chaincode function and arguments.

Sample chaincode invoke for the "createAsset" function. Response will contain transaction ID for a successful invoke.

curl --request POST \
  --url http://localhost:3000/invoke \
  --header 'content-type: application/x-www-form-urlencoded' \
  --data = \
  --data channelid=mychannel \
  --data chaincodeid=basic \
  --data function=createAsset \
  --data args=Asset123 \
  --data args=yellow \
  --data args=54 \
  --data args=Tom \
  --data args=13005

Sample chaincode query for getting asset details.

curl --request GET \
  --url 'http://localhost:3000/query?channelid=mychannel&chaincodeid=basic&function=ReadAsset&args=Asset123'