List Certificate¶

List all certificates bound to the device.

Operation Permissions¶

Required Authorization	Required Operation Permission
Device Management	Read Access

Request Format¶

GET http://{apigw-address}/connect-service/v2.0/certificates?action=list

Request Parameters (URI)¶

Note

One of the following options must be used in a request to specify a device

assetId
productKey + deviceKey

Request Parameters (URI)¶
Name	Location (Path/Query)	Required or Not	Data Type	Description
orgId	Query	True	String	Organization ID which the asset belongs to. How to get Organization ID>>
assetId	Query	false	String	Asset ID of the device
productKey	Query	false	String	Product key of the device
deviceKey	Query	false	String	Device key of the device

Response Parameters¶

Response Parameters¶
Name	Data Type	Description
data	DeviceCertDetailInfo object	Certificate information. See the table below for its structure.

DeviceCertDetailInfo Object¶

Sample¶

Java SDK Sample¶

package com.envisioniot.enos.api.sample.connect_service.cert;

import com.envision.apim.poseidon.config.PConfig;
import com.envision.apim.poseidon.core.Poseidon;
import com.envisioniot.enos.connect_service.v2_1.cert.ListCertificatesRequest;
import com.envisioniot.enos.connect_service.v2_1.cert.ListCertificatesResponse;
import com.envisioniot.enos.connect_service.vo.CertificateInfo;
import com.envisioniot.enos.connect_service.vo.DeviceIdentifier;

import java.util.List;

public class ListCert {

    public static void main(String[] args) {
        ListCertificatesRequest listCertificatesRequest = new ListCertificatesRequest();
        String appKey = "e36cc693-3a07-456e6cafcbc2-9314-4ff6";
        String appSecret = "6cafcbc2-9314-4ff6-9450-861d4344a431";
        String serverUrl = "http://apim-apigw-proxy.alpha-k8s-cn4.eniot.io";

        String orgId = "o15444172373271";
        DeviceIdentifier device = new DeviceIdentifier();
        // Either assetId or productKey + deviceKey is required.
        device.setProductKey("ymcDiAHd");
        device.setAssetId("KloXinjW");
        device.setDeviceKey("TT6MyEFaO7");
        listCertificatesRequest.setDevice(device);
        listCertificatesRequest.setOrgId(orgId);
        ListCertificatesResponse certRsp = Poseidon.config(PConfig.init().appKey(appKey).appSecret(appSecret).debug())
                .url(serverUrl)
                .getResponse(listCertificatesRequest, ListCertificatesResponse.class);
        List<CertificateInfo> certificateInfos = certRsp.getData();
        if (certificateInfos != null) {
            for (CertificateInfo certificateInfo : certificateInfos) {
                System.out.println(certificateInfo);
            }
        }
    }
}

Error Code¶

Error Code¶
Error Code	Type	Description
99400	Error info:message: (message content), detail message: (detailed message content) device identifier is invalid orgId is null	Parameter error. Detailed cause will be given in `message` or `detailed message` . `assetId` or `productKey` + `deviceKey` is not included in the request to specify a device `orgId` is not included in the request
11404	device can not be found	No device can be specified by `assetId` or `productKey` + `deviceKey`.
99500	hub service internal error! certificate service err info:code: x, message: y, detail message: z certificate service internal error!	Internal error Internal CA service error. Detailed causes are given in `message` or `detail message` . Internal certificate error