获取数字化证书

POST

/topapi/edu/cert/get

**
接口调用量说明**钉钉标准版接口累计可调用次数为1万次/月，当前接口会消耗调用次数。若该调用量无法满足需求，你可升级钉钉专业版(Open API调用量50万次/月)或钉钉专属版(Open API调用量500万次/月)扩容调用次数。

调用本接口，获取数字化证书。

调用本接口，可获取学校老师的数字化证书，包括当前用户最高认证等级、认证明细、当前等级认证状态等。

权限

服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。

应用类型	是否支持调用	权限申请方式	API Explorer调试
企业内部应用	是	钉钉教育行业数字化认证信息读权限	调试
第三方企业应用	是	钉钉教育行业数字化认证信息读权限	调试
第三方个人应用	否	—	—

请求参数

Query 参数

Body 参数application/json

示例

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://oapi.dingtalk.com/topapi/edu/cert/get?access_token=Be3xxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
    "userid": "user01"
}'

响应示例

{
    "errcode": 0,
    "result": {
        "current_cert_level": 1,
        "cert_datas": {
            "cert_status": 2,
            "can_cert": true,
            "cert_level": 2
        },
        "practical_task_data": {
            "finish": true,
            "task_code": "sendImMsg"
        }
    },
    "success": true
}

修改于 2024-01-23 03:59:43

获取班级圈动态列表

获取用户所在的行业角色信息

获取数字化证书

权限#

请求参数

返回响应

权限