Querying the System-Hosted Certificate Status

This API is used to query the status of a certificate that is hosted by system.

POST /v2/agent/apis/cert/status/{channel_id}

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
channel_id	Yes	String	Channel name. The value can contain 4 to 24 characters and cannot be the same as the system channel name (testchainid).

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	User token.

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
user_name	No	String	Username used for generating a user certificate. Either user_name or cert_value needs to be transferred. The service preferentially reads the value of user_name. Users can use the username or directly transfer the certificate content to query the certificate status.
cert_value	No	String	Certificate content returned by the Generating a User Certificate API. The content is the content of the signcerts file in the file returned by the API for generating a user certificate, and \n is added to the end of the parameter value.
org_name	Yes	String	Organization name used for generating a user certificate.

Status code: 200

**Table 4** Response body parameters
Parameter	Type	Description
[items]	Array of booleans	Request sent. Certificate status contained in the response, which can be true (normal) or false (frozen).

Status code: 400

POST  https://192.168.0.90:30603/v2/agent/apis/cert/status/channeltest

Status code: 400

Bad Request

{
  "error_code" : "BCS.4000013",
  "error_msg" : "request body is too large"
}

Status Code	Description
200	Request sent. Certificate status contained in the response, which can be true (normal) or false (frozen).
400	Bad Request

Parent topic: Chaincode Management

Thank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.

The system is busy. Please try again later.

Which of the following issues have you encountered?

Content is inconsistent with the product UI

Unclear descriptions

Lack of examples or code

Incorrect steps

Can't find what I need

Lack of best practices

Feedback (optional)

0/500

Select at least one type of issue, and enter your comments or suggestions.

Enter a maximum of 500 characters.

Submit Cancel

For any further questions, feel free to contact us through the chatbot.