Querying a Data Set Sharing Process

Function

This API is used to query a data set sharing process.

URI

POST /v1/datashare/dataset/query-process

Request Parameters

**Table 1** Request body parameters
Parameter	Mandatory	Type	Description
orgID	Yes	String	Organization ID.
channelID	Yes	String	Channel ID.
cryptoMethod	Yes	String	Encryption method, which is fixed at SW.
cert	Yes	String	Certificate.
sk	Yes	String	Private key.
timestamp	Yes	String	Timestamp.
creatorDID	Yes	String	Process creator identifier.
processID	Yes	String	Process ID.

Response Parameters

Status code: 200

**Table 2** Response body parameters
Parameter	Type	Description
creatorDID	String	Process creator identifier.
processID	String	Process ID.
stages	Array of StageInProcess objects	Information about a stage in the process.

**Table 3** StageInProcess
Parameter	Type	Description
stageName	String	Stage name.
createTime	String	Timestamp when the stage information is stored to the blockchain.
consumer	String	Consumer identifier.
orderSeq	String	Order number.

Status code: 500

**Table 4** Response body parameters
Parameter	Type	Description
errorCode	String	Error code.
errorMsg	String	Error description.

Example Requests

/v1/datashare/dataset/query-process

{
  "orgID" : "{{orgID}}",
  "channelID" : "{{channelID}}",
  "cryptoMethod" : "{{cryptoMethod}}",
  "cert" : "{{cert}}",
  "sk" : "{{sk}}",
  "timestamp" : "{{timestamp}}",
  "creatorDID" : "did:example:8sAvsS4tB3NYgMJ4uqbVYj",
  "processID" : "a779dd88-f7a3-4ac9-bf1c-a0ed1d827632"
}

Example Responses

Status code: 200

Parameters in the response to the request for querying a specific data set sharing process.

{
  "creatorDID" : "did:example:YLgvmFcukyigJpRsqRbFMn",
  "processID" : "25f46489-29bb-4f58-8f4c-e12da0a4bd66",
  "stages" : [ {
    "stageName" : "transaction1",
    "createTime" : "1640574210",
    "consumer" : "did:example:My8PRB5dKDVvBKXT76oJoB",
    "orderSeq" : "8zLQUpyswA8kpiHEsAUhZN"
  }, {
    "stageName" : "transaction2",
    "createTime" : "1640574304",
    "consumer" : "did:example:T1kFDUQAqo2z2X7hJWiRtQ",
    "orderSeq" : "3oKCPSKLGvaebT6z3a4PvY"
  }, {
    "stageName" : "transaction2",
    "createTime" : "1640587323",
    "consumer" : "did:example:T1kFDUQAqo2z2X7hJWiRtQ",
    "orderSeq" : "GPSta7mTScEEaQVRB62wUF"
  }, {
    "stageName" : "transaction2",
    "createTime" : "1640680918",
    "consumer" : "did:example:T1kFDUQAqo2z2X7hJWiRtQ",
    "orderSeq" : "8kzahSLi2kBxY8GGBZdLhp"
  } ]
}