1 进入文本识别控制台
控制台是文字识别的管理页面，您可通过控制台执行查看应用、创建应用、查看服务、购买预付费套餐包等操作。
1.1 通过产品页进入
1.2 通过控制台进入
2 创建应用
本节介绍创建应用，订阅服务的详细操作。
2.1 创建应用
在“应用列表”下，点击“应用创建”按钮，进入创建应用页面，填写应用名称，选填应用描述，点击“立即创建”进入下一步。
2.2 生成Token
点击“立即生成Secret Key”按钮，系统会给应用生成Consumer Key，Consumer Secret，访问服务的Token，Token有效期等信息。点击下一步进入“订阅服务”页面。
2.3 订阅服务
勾选文字识别下需要订阅的服务，则这个应用的Token被授权访问已订阅的服务。点击“立即订阅”按钮，完成创建应用过程。
在应用列表页面可以看到刚刚创建好的应用，在Token列点击“眼睛”按钮，显示Consumer Key，Consumer Secret，Token详情。我们将通过Token认证方式调用服务的API请求。
3 发送请求
本节以身份证识别为例，识别一张正面身份证。通过Token认证方式调用身份证识别的API请求。
3.1 请求说明
3.1.1 请求方式
调用地址：https://apim.unicloud.com/api/ocr/idcard/1.0.0/
请求方式：POST
返回类型：JSON
3.1.2 请求参数
Header如下：
| 参数 | 值 |
|---|
| Content-Type | application/json |
| Authorization | Bearer |
Body如下：
| 参数 | 是否必选 | 类型 | 可选值范围 | 说明 |
|---|
| idcard_pic | true | file | -- | 身份证正面或反面图片（支持jpg、jpeg、png格式） |
注：Body使用form-data形式
3.1.3 请求示例
curl -k -H "Authorization:Bearer 2b8296e1-86a5-3a68-bd61-9b88f9dce5c0" \
-F "idcard_pic=@imgpath.jpg" https://apim.unicloud.com/api/ocr/idcard/1.0.0/
curl -k -H "Authorization:Bearer 2b8296e1-86a5-3a68-bd61-9b88f9dce5c0" \
-F "idcard_pic=@imgpath.jpg" \
https://apim.unicloud.com/api/ocr/idcard/1.0.0/
curl -k -H "Authorization:Bearer 2b8296e1-86a5-3a68-bd61-9b88f9dce5c0" -F "idcard_pic=@imgpath.jpg" https://apim.unicloud.com/api/ocr/idcard/1.0.0/
注：发送请求时，Token请填写上面创建应用后得到的Token
3.2 返回说明
3.2.1 返回参数
| 字段 | 类型 | 说明 |
|---|
| sex | string | 性别 |
| name | string | 姓名 |
| ID_num | string | 身份证ID号 |
| birth | string | 出生年月日 |
| address | string | 户口所在的地址 |
| nation | string | 民族 |
| period_of_validity | string | 身份证有效期 |
| department | string | 签发机关 |
| code | string | 是否正常返回（“succeed”,”failed”） |
3.2.2 返回示例
身份证正面：
{
"Data": {
"name": "张三",
"ID_num": "511XXXXXXXXXXXXXXX",
"nation": "汉",
"address": "XX省XX市XX区XX街道XX号",
"birth": "1986年8月13日",
"sex": "男"
},
"code": "succeed"
}身份证反面：
{
"Data": {
"period_of_validity": "2012.06.11-2022.06.11",
"department": "北京市公安局海淀分局"
},
"code": "succeed"
}{
"Data": {
"period_of_validity": "2012.06.11-2022.06.11",
"department": "北京市公安局海淀分局"
},
"code": "succeed"
}{ "Data": { "period_of_validity": "2012.06.11-2022.06.11", "department": "北京市公安局海淀分局"
}, "code": "succeed"}3.3 通过Postman发送请求示例
