华为云用户手册

请求示例 “endpoint”即调用API的请求地址，不同服务不同区域的“endpoint”不同，具体请参见终端节点。 例如，网络图片识别服务部署在“华南-广州”区域的“endpoint”为“ocr.cn-south-1.myhuaweicloud.com”或“ocr.cn-south-1.myhuaweicloud.cn”，请求URL为“https://ocr.cn-south-1.myhuaweicloud.com/v2/{project_id}/ocr/web-image”，“project_id”为项目ID，获取方法请参见获取项目ID。 如何 获取Token 请参见认证鉴权。 传入网络图片的base64编码进行 文字识别 ，识别过程校验图片倾斜角度，判断待识别字体类型，并校验图片是否包含联系人信息 POST https://{endpoint}/v2/{project_id}/ocr/web-image Request Header: Content-Type: application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body: { "image":"/9j/4AAQSkZJRgABAgEASABIAAD/...", "extract_type" : [ "contact_info", "image_size" ], "detect_direction" : true, "detect_font" : true } 传入网络图片的url进行文字识别，识别过程校验图片倾斜角度，判断待识别字体类型，并校验图片是否包含联系人信息 POST https://{endpoint}/v2/{project_id}/ocr/web-image Request Header: Content-Type: application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body: { "url":"https://BucketName.obs.xxxx.com/ObjectName", "extract_type" : [ "contact_info", "image_size" ], "detect_direction" : true, "detect_font" : true }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 用于获取操作API的权限。获取Token接口响应消息头中X-Subject-Token的值即为Token。 Content-Type 是 String 发送的实体的MIME类型，参数值为“application/json”。 Enterprise-Project-Id 否 String 企业项目ID。OCR支持通过企业项目管理（EPS）对不同用户组和用户的资源使用，进行分账。 获取方法：进入“企业项目管理”页面，单击企业项目名称，在企业项目详情页获取Enterprise-Project-Id（企业项目ID）。 企业项目创建步骤请参见用户指南。 说明： 该功能仅支持开通在华北-北京四、华东-上海一区域的API。 创建企业项目后，在传参时，有以下三类场景。 携带正确的ID，正常使用OCR服务，账单归到企业ID对应的企业项目中。 携带错误的ID，正常使用OCR服务，账单的企业项目会被分类为“未归集”。 不携带ID，正常使用OCR服务，账单的企业项目会被分类为“未归集”。 表3 请求Body参数 参数 是否必选 参数类型 说明 image 否 String 该参数与url二选一。 图片的Base64编码，要求Base64编码后大小不超过10MB。 图片最短边不小于15px，最长边不超过8192px，支持JPG、JPEG、PNG、BMP、TIFF、TGA、WEBP、ICO、PCX、GIF格式。 图片Base64编码示例如/9j/4AAQSkZJRgABAg...，带有多余前缀会产生The image format is not supported报错。 url 否 String 该参数与image二选一。图片的url路径，目前支持： 公网http/https url例如https://support.huaweicloud.com/api-ocr/zh-cn_image_0288038400.png OBS提供的url，使用OBS数据需要进行授权。包括对服务授权、临时授权、匿名公开授权，详情参见配置OBS访问权限。 说明： 接口响应时间依赖于图片的下载时间，如果图片下载时间过长，会返回接口调用失败。 请保证被检测图片所在的存储服务稳定可靠，推荐使用OBS服务存储图片数据。 url中不能存在中文字符，若存在，中文需要进行utf8编码。 detect_direction 否 Boolean 是否校正图片的倾斜角度，可选值如下。 true：校正图片的倾斜角度 false：不校正图片的倾斜角度 支持任意角度的校正，未传入该参数时默认为“false”。 待识别图片如果存在倾斜，建议将此参数设置为“true”。 extract_type 否 Array of strings 结构化数据提取参数列表，目前只支持联系人信息、图像宽高，其入参值分别为“contact_info”，“image_size”。 若不填写该参数或删除该参数，默认不提取该参数值。 detect_font 否 Boolean 为Boolean类型，若不传该字段，默认不检测切片字体，为True时，将检测切片的字体类型，并返回最相似的5种字体名称。 detect_text_direction 否 Boolean 为Boolean类型，若不传该字段，默认为True，即检测每个字段的文字方向。为False时，则不检测文字方向。若图片中所有文字方向均是水平朝上时，建议将该值设为False，即不检测文字方向。

URI POST /v2/{project_id}/ocr/web-image 表1 路径参数 参数 是否必选 说明 endpoint 是 终端节点，即调用API的请求地址。 不同服务不同区域的endpoint不同，您可以从终端节点中获取。 例如，OCR服务在“华北-北京四”区域的“endpoint”为“ocr.cn-north-4.myhuaweicloud.com”。 project_id 是 项目ID，您可以从获取项目ID中获取。

响应示例 状态码：200 成功响应示例1 { "result" : { "code" : "144031624150", "number" : "00446874", "machine_printed_code" : "144031624150", "machine_printed_number" : "00446874", "issue_date" : "2017-07-19", "machine_number" : "49991450XXXX", "buyer_name" : "深圳市宝安区XXX", "buyer_organization_number" : "XXX", "buyer_id" : "XXX", "seller_name" : "深圳市XXX服务有限公司", "seller_phone" : "0755-XXX", "seller_id" : "XXX", "seller_account" : "XXX", "seller_address" : "深圳市宝安区松岗街道办XXX", "seller_bank" : "建设银行深圳XX支行", "vehicle_type" : "多用途乘用车", "brand_model" : "东风日产牌/XXX", "manufacturing_location" : "大连市", "quality_certificate" : "XXX", "import_certificate" : "", "inspection_number" : "", "engine_number" : "XXX", "vehicle_identification_number" : "XXX", "tonnage" : "", "seating_capacity" : "5", "tax_authority" : "深圳市宝安区国家税务局XXX税务分局", "tax_authority_code" : "144030614", "tax_payment_receipt" : "", "tax_rate" : "17%", "tax" : "￥21475.21", "tax_exclusive_price" : "￥126324.79", "total" : "￥147800.00", "total_chinese" : "壹拾肆万柒仟捌佰圆整", "fiscal_code" : "" } } 成功响应示例2 { "result" : { "used_vehicle_market_name" : "动车交易有限公司", "auction_org_bank_account" : "10468888888830", "seller_phone" : "13988888888", "buyer_id" : "AB37836SDWGDUOHDOEHD3", "machine_printed_number" : "00888858", "auction_org_id" : "AB37836SDWGDUOHDOEHD3", "auction_org_name" : "某拍卖行", "buyer_name" : "汽车贸易有限公司", "used_vehicle_market_id" : "91DEDD3782733DJ6R", "used_vehicle_market_phone" : "07588888888", "code" : "044008888817", "machine_number" : "4888888182", "used_vehicle_market_address" : "佛山市", "seller_address" : "广东省佛山市", "auction_org_address" : "广东省佛山市", "brand_model" : "吉利莫车型", "licence_plate_number" : "粤A88888", "seller_id" : "AB37836SDWGDUOHDOEHD3", "machine_printed_code" : "10468888888830", "registration_number" : "1234EHWEGG8888830", "buyer_phone" : "13988888888", "vehicle_type" : "小型轿车", "drawer_name" : "张三", "total" : "￥20000.00", "total_chinese" : "贰万圆整", "issue_date" : "1987-12-27", "seller_name" : "李四", "vehicle_identification_number" : "L6T7804826379E3GG875", "auction_org_phone" : "13988888888", "used_vehicle_market_bank_account" : "中国农业银行", "buyer_address" : "佛山市", "dept_motor_vehicles" : "广东省佛山市车管所", "remark" : "免税开具", "reverse_issue" : false, "number" : "003753534", "fiscal_code" : "017807816386738245", "type" : "二手车销售统一发票" } } 状态码：400 失败响应示例 { "error_code": "AIS.0103", "error_msg": "The image size does not meet the requirements." }

请求示例 “endpoint”即调用API的请求地址，不同服务不同区域的“endpoint”不同，具体请参见终端节点。 例如，机动车销售发票识别服务部署在“华北-北京四”区域的“endpoint”为“ocr.cn-north-4.myhuaweicloud.com”或“ocr.cn-north-4.myhuaweicloud.cn”，请求URL为“https://ocr.cn-north-4.myhuaweicloud.com/v2/{project_id}/ocr/mvs-invoice”，“project_id”为项目ID，获取方法请参见获取项目ID 如何获取Token请参见认证鉴权。 传入机动车销售发票图片的base64编码进行文字识别 POST https://{endpoint}/v2/{project_id}/ocr/mvs-invoice Request Header: Content-Type: application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body: { "image" : "/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAA...", "type" : "auto" } 传入机动车销售发票图片的url进行文字识别 POST https://{endpoint}/v2/{project_id}/ocr/mvs-invoice Request Header: Content-Type: application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body: { "url":"https://BucketName.obs.xxxx.com/ObjectName" }

响应参数 根据识别的结果，可能有不同的HTTP响应状态码（status code）。例如，200表示API调用成功，400表示调用失败，详细的状态码和响应参数说明如下。 状态码： 200 表4 响应Body参数 参数 参数类型 描述 result MvsInvoiceResult object 识别结果。 调用失败时不返回此字段。 表5 MvsInvoiceResult 参数 参数类型 描述 code String 发票代码。 number String 发票号码。 machine_printed_code String 机打代码。 machine_printed_number String 机打号码。 issue_date String 开票日期。 machine_number String 机器编号。 buyer_name String 购买方的名称、二手车买方单位/个人。 buyer_organization_number String 购买方身份证号码/组织机构代码。 buyer_id String 购买方纳税人识别号、二手车买方单位代码/身份证号。 buyer_address String 二手车买方单位/个人住址，当请求参数"type"设置为"auto"或"used"时才返回。 buyer_phone String 二手车买方单位/个人电话，当请求参数"type"设置为"auto"或"used"时才返回。 seller_name String 销货单位名称、二手车卖方单位/个人。 seller_phone String 销售方电话、二手车卖方电话。 seller_id String 销售方纳税人识别号、二手车卖方单位代码/身份证号。 seller_account String 销售方账号。 seller_address String 销售方地址、二手车卖方单位/个人地址。 licence_plate_number String 二手车车牌照号，当请求参数"type"设置为"auto"或"used"时才返回。 registration_number String 二手车登记证号，当请求参数"type"设置为"auto"或"used"时才返回。 dept_motor_vehicles String 二手车转入地车管所名称，当请求参数"type"设置为"auto"或"used"时才返回。 seller_bank String 销售方开户行。 vehicle_type String 车辆类型。 brand_model String 厂牌型号。 manufacturing_location String 产地。 quality_certificate String 合格证号。 import_certificate String 进口证明书号。 inspection_number String 商检单号。 engine_number String 发动机号码。 vehicle_identification_number String 车辆识别代号/车架号码。 tonnage String 吨位。 seating_capacity String 限乘人数。 tax_authority String 主管税务机关。 tax_authority_code String 主管税务机关代码。 tax_payment_receipt String 完税凭证号码。 tax_rate String 增值税税率或征收率。 tax String 增值税税额。 tax_exclusive_price String 不含税价。 total String 价税合计、二手车车价合计（小写）。 total_chinese String 价税合计大写、二手车车价合计（大写）。 fiscal_code String 税控码。 auction_org_name String 二手车经营拍卖单位名称，当请求参数"type"设置为"auto"或"used"时才返回。 auction_org_address String 二手车经营拍卖单位地址，当请求参数"type"设置为"auto"或"used"时才返回。 auction_org_id String 二手车经营拍卖单位纳税人识别号，当请求参数"type"设置为"auto"或"used"时才返回。 auction_org_bank_account String 二手车经营拍卖单位银行和账号，当请求参数"type"设置为"auto"或"used"时才返回。 auction_org_phone String 二手车经营拍卖单位电话，当请求参数"type"设置为"auto"或"used"时才返回。 used_vehicle_market_name String 二手车市场名称，当请求参数"type"设置为"auto"或"used"时才返回。 used_vehicle_market_id String 二手车市场纳税人识别号，当请求参数"type"设置为"auto"或"used"时才返回。 used_vehicle_market_address String 二手车市场地址，当请求参数"type"设置为"auto"或"used"时才返回。 used_vehicle_market_bank_account String 二手车市场银行和账号，当请求参数"type"设置为"auto"或"used"时才返回。 used_vehicle_market_phone String 二手车市场电话，当请求参数"type"设置为"auto"或"used"时才返回。 reverse_issue Boolean 二手车反向开具标识，True表示是反向开具发票，False表示不是反向开具发票。 当请求参数"type"设置为"auto"或"used"时才返回。 remark String 备注。 drawer_name String 开票人。 type String 枚举值，机动车销售统一发票或者二手车销售统一发票。 当入参中包含type时返回。 text_location Object 检测框对象，内部为字段-框坐标对。如 code:[[x0, y0],[x1,y1],[x2,y2],[x3,y3]], 点的顺序是左上角、右上角、右下角、左下角。如果原图找不到字段，返回空列表。 confidence Object 字段文字内容置信度，内容为字段-字符置信度对,如code:0.9999。这个数值为字段中每个字符置信度，格式为fp32，保留四位。若字段不存在则返回0.0。 状态码： 400 表6 响应Body参数 参数 参数类型 说明 error_code String 调用失败时的错误码，具体请参见错误码。 当出现错误码“ModelArts.4204”时，请参考为什么调用API时提示“ModelArts.4204”？章节。 调用成功时不返回此字段。 error_msg String 调用失败时返回的错误信息。 调用成功时不返回此字段。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 用于获取操作API的权限。获取Token接口响应消息头中X-Subject-Token的值即为Token。 Content-Type 是 String 发送的实体的MIME类型，参数值为“application/json”。 Enterprise-Project-Id 否 String 企业项目ID。OCR支持通过企业项目管理（EPS）对不同用户组和用户的资源使用，进行分账。 获取方法：进入“企业项目管理”页面，单击企业项目名称，在企业项目详情页获取Enterprise-Project-Id（企业项目ID）。 企业项目创建步骤请参见用户指南。 说明： 创建企业项目后，在传参时，有以下三类场景。 携带正确的ID，正常使用OCR服务，账单归到企业ID对应的企业项目中。 携带错误的ID，正常使用OCR服务，账单的企业项目会被分类为“未归集”。 不携带ID，正常使用OCR服务，账单的企业项目会被分类为“未归集”。 表3 请求Body参数 参数 是否必选 参数类型 说明 image 否 String 该参数与url二选一。 图片的Base64编码，要求Base64编码后大小不超过10MB。 图片最短边不小于100px，最长边不超过8000px。支持JPEG、JPG、PNG、BMP、TIFF、PDF格式。多页PDF仅识别第一页。 图片Base64编码示例如/9j/4AAQSkZJRgABAg...，带有多余前缀会产生The image format is not supported报错。 url 否 String 该参数与image二选一。图片的url路径，目前支持： 公网http/https url OBS提供的url，使用OBS数据需要进行授权。包括对服务授权、临时授权、匿名公开授权，详情参见配置OBS访问权限。 说明： 接口响应时间依赖于图片的下载时间，如果图片下载时间过长，会返回接口调用失败。 请保证被检测图片所在的存储服务稳定可靠，推荐使用OBS服务存储图片数据。 url中不能存在中文字符，若存在，中文需要进行utf8编码。 return_text_location 否 Boolean 如果为True，返回体中会包含text_location对象，内容是各字段的检测框四点坐标。 如果为False或者没有这个key，返回体中不包含text_location对象。 return_confidence 否 Boolean 如果为True，返回体中包含confidence对象，内容是各字段的置信度。 如果为False或者没有这个key，返回体中不包含confidence对象。 type 否 String 如果没有type字段则默认返回原机动车销售发票出参。 如果存在type字段但是不属于 auto、new或者used三个枚举值，API返回AIS.0101入参错误。 如果type为auto，API自动判断发票类型，并在返回参数中添加type出参以指明发票类型。 如果type为new，API在检测出的类型为机动车发票时返回原版机动车发票出参并添加type出参（机动车销售统一发票），不一致时报错AIS.0104图像质量差。 如果type为used，API在检测出的类型为二手车时返回二手车发票出参，并添加type出参（二手车销售统一发票），不一致时报错AIS.0104图像质量差。

URI POST /v2/{project_id}/ocr/mvs-invoice 表1 路径参数 参数 是否必选 说明 endpoint 是 终端节点，即调用API的请求地址。 不同服务不同区域的endpoint不同，您可以从终端节点中获取。 例如，OCR服务在“华北-北京四”区域的“endpoint”为“ocr.cn-north-4.myhuaweicloud.com”。 project_id 是 项目ID，您可以从获取项目ID中获取。

请求URI 请求URI由如下部分组成。 {URI-scheme} :// {endpoint} / {resource-path} ? {query-string} 尽管请求URI包含在请求消息头中，但大多数语言或框架都要求您从请求消息中单独传递它，所以在此单独强调。 表1 URI中的参数说明 参数 说明 URI-scheme 表示用于传输请求的协议，当前所有API均采用HTTPS协议。 endpoint 指定承载REST服务端点的服务器域名或IP，不同服务不同区域的endpoint不同，您可以从终端节点章节查看。 例如OCR服务在“华北-北京四”区域的“endpoint”为“ocr.cn-north-4.myhuaweicloud.com”。 resource-path 资源路径，也即API访问路径。 从具体API的URI章节获取，例如网络图片识别API的“resource-path”为“v2/{project_id}/ocr/web-image”。 query-string 查询参数，是可选部分，并不是每个API都有查询参数。查询参数前面需要带一个“？”，形式为“参数名=参数取值”，例如“limit=10”，表示查询不超过10条数据。 例如，在“华北-北京四”区域调用网络图片识别API，则需使用“华北-北京四”区域的endpoint（ocr.cn-north-4.myhuaweicloud.com），拼接起来如下所示。 https://ocr.cn-north-4.myhuaweicloud.com/v2/{project_id}/ocr/web-image 图1 URI示意图 为查看方便，在每个具体API的URI部分，只给出resource-path部分，并将请求方法写在一起。这是因为URI-scheme都是HTTPS，而endpoint在同一个区域也相同，所以简洁起见将这两部分省略。

请求方法 HTTP请求方法（也称为操作或动词），它告诉服务你正在请求什么类型的操作。 表2 HTTP方法 方法 说明 GET 请求服务器返回指定资源。 PUT 请求服务器更新指定资源。 POST 请求服务器新增资源或执行特殊操作。 DELETE 请求服务器删除指定资源，如删除对象等。 HEAD 请求服务器资源头部。 PATCH 请求服务器更新资源的部分内容。 当资源不存在的时候，PATCH可能会去创建一个新的资源。 例如，网络图片识别URI部分，您可以看到其请求方法为“POST”，则其请求为： POST https://ocr.cn-north-4.myhuaweicloud.com/v2/{project_id}/ocr/web-image

请求消息头 附加请求头字段，如指定的URI和HTTP方法所要求的字段。例如定义消息体类型的请求头“Content-Type”，请求鉴权信息等。 Content-Type：消息体的类型（格式），必选，默认取值为“application/json”，有其他取值时会在具体接口中专门说明。 X-Auth-Token：用户Token，可选，当使用Token方式认证时，必须填充该字段。用户Token请参考认证鉴权章节。 添加消息头后的请求如下所示。 POST https://ocr.cn-north-4.myhuaweicloud.com/v2/{project_id}/ocr/web-image Content-Type: application/json x-auth-token: MIIaBgYJKoZIhvcNAQcC…

请求消息体 请求消息体通常以结构化格式发出，与请求消息头中Content-type对应，传递除请求消息头之外的内容。若请求消息体中参数支持中文，则中文字符必须为UTF-8编码。 每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。 例如，对于网络图片识别接口，您可以从接口的请求部分看到所需的请求参数及参数说明。将消息体加入后的请求如下所示。 POST https://ocr.cn-north-4.myhuaweicloud.com/v2/{project_id}/ocr/web-image Request Header: Content-Type: application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body: { "image":"/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAA..." } 到这里为止这个请求需要的内容就具备齐全了，您可以使用curl、Postman或直接编写代码等方式发送请求调用API。

响应示例 状态码：200 成功响应示例 { "result": { "location": "上海市", "code": "130XXXXXXXX88", "number": "00XXXX08", "phone_number": "62XXX22", "company": "", "taxi_number": "GXXXXXX", "certificate_number": "3XXXX9", "identification_number": "", "date": "2019-03-15", "boarding_time": "12:03", "alighting_time": "12:15", "time": "12:03-12:15", "unit_price": "￥2.50", "distance": "7.8", "waiting_time": "00:02:09", "fare": "￥29.00", "fuel_oil_surcharge": "￥0.00", "call_service_surcharge": "￥0.00", "total": "￥29.00", "confidence": { "location": 0.9977, "code": 0.9998, "number": 0.9976, "phone_number": 0.859, "company": 0, "taxi_number": 0.9607, "certificate_number": 0.9411, "identification_number": 0, "date": 0.9665, "boarding_time": 0.9847, "alighting_time": 0.9798, "time": 0.9798, "unit_price": 0.9174, "distance": 0.9731, "waiting_time": 0.9936, "fare": 0.9896, "fuel_oil_surcharge": 0.8433, "call_service_surcharge": 0.7843, "total": 0.9896 } } } 状态码：400 失败响应示例 { "error_code": "AIS.0103", "error_msg": "The image size does not meet the requirements." }

请求示例 “endpoint”即调用API的请求地址，不同服务不同区域的“endpoint”不同，具体请参见终端节点。 例如，出租车发票识别服务部署在“华北-北京四”区域的“endpoint”为“ocr.cn-north-4.myhuaweicloud.com”或“ocr.cn-north-4.myhuaweicloud.cn”，请求URL为“https://ocr.cn-north-4.myhuaweicloud.com/v2/{project_id}/ocr/taxi-invoice”，“project_id”为项目ID，获取方法请参见获取项目ID 如何获取Token请参见认证鉴权。 传入出租车发票图片的base64编码进行文字识别 POST https://{endpoint}/v2/{project_id}/ocr/taxi-invoice Request Header: Content-Type: application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body: { "image":"/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAA..." } 传入出租车发票图片的url进行文字识别 POST https://{endpoint}/v2/{project_id}/ocr/taxi-invoice Request Header: Content-Type: application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body: { "url":"https://BucketName.obs.xxxx.com/ObjectName" }

响应参数 根据识别的结果，可能有不同的HTTP响应状态码（status code）。例如，200表示API调用成功，400表示调用失败，详细的状态码和响应参数说明如下。 状态码： 200 表4 响应Body参数 参数 参数类型 描述 result TaxiInvoiceResult object 识别结果。 调用失败时不返回此字段。 表5 TaxiInvoiceResult 参数 参数类型 描述 location String 归属地区。 code String 发票代码。 number String 发票号码。 phone_number String 电话（包括电话、监督电话）。 company String 单位。 taxi_number String 车号。 certificate_number String 证号。 identification_number String 识别编号。 date String 开票日期。 boarding_time String 上车时间。 alighting_time String 下车时间。 time String 时间(起止时间、上下车时间)。 unit_price String 单价。 distance String 总里程。 waiting_time String 等候时间。 fare String 金额。 fuel_oil_surcharge String 燃油附加费。 call_service_surcharge String 电调费（预约费）。 total String 实收金额。 confidence Object 字段的置信度，取值范围0~1。 置信度越大，本次识别的字段的可靠性越高，在统计意义上，置信度越大，准确率越高。 置信度由算法给出，不直接等价于字段的准确率。 text_location Object 对应所有在原图上识别到的字段位置信息，包含所有文字区域四个顶点的二维坐标（x,y）。采用图像坐标系，坐标原点为图片左上角，x轴沿水平方向，y轴沿竖直方向。 状态码： 400 表6 响应Body参数 参数 参数类型 说明 error_code String 调用失败时的错误码，具体请参见错误码。 当出现错误码“ModelArts.4204”时，请参考为什么调用API时提示“ModelArts.4204”？章节。 调用成功时不返回此字段。 error_msg String 调用失败时返回的错误信息。 调用成功时不返回此字段。

URI POST /v2/{project_id}/ocr/taxi-invoice 表1 路径参数 参数 是否必选 说明 endpoint 是 终端节点，即调用API的请求地址。 不同服务不同区域的endpoint不同，您可以从终端节点中获取。 例如，OCR服务在“华北-北京四”区域的“endpoint”为“ocr.cn-north-4.myhuaweicloud.com”。 project_id 是 项目ID，您可以从获取项目ID中获取。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 用于获取操作API的权限。获取Token接口响应消息头中X-Subject-Token的值即为Token。 Content-Type 是 String 发送的实体的MIME类型，参数值为“application/json”。 Enterprise-Project-Id 否 String 企业项目ID。OCR支持通过企业项目管理（EPS）对不同用户组和用户的资源使用，进行分账。 获取方法：进入“企业项目管理”页面，单击企业项目名称，在企业项目详情页获取Enterprise-Project-Id（企业项目ID）。 企业项目创建步骤请参见产品介绍。 说明： 创建企业项目后，在传参时，有以下三类场景。 携带正确的ID，正常使用OCR服务，账单归到企业ID对应的企业项目中。 携带错误的ID，正常使用OCR服务，账单的企业项目会被分类为“未归集”。 不携带ID，正常使用OCR服务，账单的企业项目会被分类为“未归集”。 表3 请求Body参数 参数 是否必选 参数类型 说明 image 否 String 该参数与url二选一。 图片的Base64编码，要求Base64编码后大小不超过10MB。 图片最短边不小于15px，最长边不超过4096px，支持JPEG、JPG、PNG、BMP、TIFF格式。 图片Base64编码示例如/9j/4AAQSkZJRgABAg...，带有多余前缀会产生The image format is not supported报错。 url 否 String 该参数与image二选一。图片的url路径，目前支持： 公网http/https url OBS提供的url，使用OBS数据需要进行授权。包括对服务授权、临时授权、匿名公开授权，详情参见配置OBS访问权限。 说明： 接口响应时间依赖于图片的下载时间，如果图片下载时间过长，会返回接口调用失败。 请保证被检测图片所在的存储服务稳定可靠，推荐使用OBS服务存储图片数据。 url中不能存在中文字符，若存在，中文需要进行utf8编码。 return_text_location 否 Boolean 识别到的文字块的区域位置信息。可选值包括： true：返回各个文字块区域 false：不返回各个文字块区域 如果无该参数，系统默认不返回文字块区域。如果输入参数不是Boolean类型，则会报非法参数错误。

配置介绍 表1 配置说明 参数 配置说明 使用当前用户token 是否使用当前用户token来获得鉴权。 获取token地址 如不使用当前用户token，需配置token地址。 获取token请求体 如不使用当前用户token，需配置token请求体。 请求地址 配置请求地址。 请求参数 （可选）配置请求参数。 请求头 （可选）配置请求头。 请求方式 配置请求方式，支持如下请求方式。 GET PUT POST DELETE PATCH 请求体 （可选）输入请求体内容。 任务名称 请自定义输入任务名称。

开通功能模块 进入开通功能模块页面。 在“开通功能模块”页面，单击勾选所需多活版本和功能点，单击右下角的“确定”。 图1 开通功能模块 表1 功能模块配置参数 参数 配置说明 版本 选择多活版本，可选择“同城多活”或“异地多活”。 功能点 “同城多活”选择如下所需功能点： MySQL Oracle PostgreSQL Redis MongoDB Elasticsearch OpenGauss API监控 收费模式 开通功能模块的收费模式，默认“按需计费”。具体计费说明，请参考价格详情。

配置介绍 表1 配置说明 参数 配置说明 任务所在region 选择任务所在区域。 内网域名 选择内网域名。 记录集类型 选择记录集类型。 A – 将域名指向IPv4地址 CNAME – 将域名指向另外一个域名 MX – 将域名指向邮件服务器地址 TXT – 设置文本记录 SRV – 记录提供特定服务的服务器 记录集的值 填写记录集的值。 主机记录 填写主机记录。 主机记录指域名前缀，如不填写，默认添加时使用内网域名。当“记录集类型”选择“CNAME”时，主机记录为必填项。 TTL（单位：秒） 填写TTL值。 TTL(Time-To-Live)指解析记录在本地DNS服务器中的缓存时间。如果您的服务地址经常更换，建议TTL值设置相对小些，反之，建议设置相对大些。 TTL应为300~2147483647之间的整数，如不填写，则默认300秒。 任务名称 请自定义输入任务名称。

配置介绍 表1 选择输入-配置说明 参数 配置说明 任务所在region 选择任务所在区域。 凭证 选择凭证，默认显示当前命名空间多活分区下已配置的默认凭证。 项目 选择项目，默认显示当前命名空间多活分区下已配置的默认项目。 任务 选择DRS灾备任务名称。 灾备切换 配置灾备切换。 升主：升为主数据库。 降备：降为备数据库。 任务名称 请自定义输入任务名称。 表2 手动输入-配置说明 参数 配置说明 任务所在region 配置任务所在区域。 项目ID 配置资源集ID。 委托用户名 （可选）配置委托用户名。 说明： 不填写委托时：默认使用当前凭证。 使用委托时：委托用户名/委托名称/委托资源集ID需要同时填写。 委托名称 （可选）配置委托名称。 委托项目ID （可选）配置委托资源集ID。 任务ID 配置DRS灾备任务ID。 灾备切换 配置灾备切换。 up：升为主数据库。 down：降为备数据库。 任务名称 请自定义输入任务名称。

配置介绍 表1 选择输入-配置说明 参数 配置说明 任务所在region 选择任务所在区域。 凭证 选择凭证，默认显示当前命名空间多活分区下已配置的默认凭证。 项目 选择项目，默认显示当前命名空间多活分区下已配置的默认项目。 任务 选择DRS灾备任务名称。 检查RPO 配置是否检查RPO。 开启 关闭 RPO阈值(单位:秒) 配置RPO阈值。 检查RTO 配置是否检查RTO。 开启 关闭 说明： 检查RPO和检查RTO必须要有一个开启。 RTO阈值(单位:秒) 配置RTO阈值。 检查时间间隔(单位:秒) 配置检查时间间隔。 检查次数 配置检查次数。 任务名称 请自定义输入任务名称。 表2 手动输入-配置说明 参数 配置说明 任务所在region 配置任务所在区域。 项目ID 配置项目ID。 委托用户名 （可选）配置委托用户名。 说明： 不填写委托时：默认使用当前凭证。 使用委托时：委托用户名/委托名称/委托项目ID需要同时填写。 委托名称 （可选）配置委托名称。 委托项目ID （可选）配置委托项目ID。 任务ID 配置DRS灾备任务ID。 检查RPO 配置是否检查RPO。 开启 关闭 RPO阈值(单位:秒) 配置RPO阈值。 检查RTO 配置是否检查RTO。 开启 关闭 说明： 检查RPO和检查RTO必须要有一个开启。 RTO阈值(单位:秒) 配置RTO阈值。 检查时间间隔(单位:秒) 配置检查时间间隔。 检查次数 配置检查次数。 任务名称 请自定义输入任务名称。

配置介绍 表1 选择输入-配置说明 参数 配置说明 任务所在region 选择任务所在区域。 凭证 选择凭证，默认显示当前命名空间多活分区下已配置的默认凭证。 项目 选择项目，默认显示当前命名空间多活分区下已配置的默认项目。 任务 选择DRS任务。 操作 请选择启动、结束或删除。 任务名称 请自定义输入任务名称。 表2 手动输入-配置说明 参数 配置说明 任务所在region 配置任务所在区域。 项目ID 配置项目ID。 凭证ID （可选）配置委托用户名。 说明： 不填写委托时：默认使用当前凭证。 使用委托时：委托用户名/委托名称/委托项目ID需要同时填写。 委托项目ID （可选）配置委托项目ID。 任务ID 输入DRS任务ID。 操作 请选填启动、结束或删除。 任务名称 请自定义输入任务名称。

跨账号执行DRS任务 当前账号通过“DRS任务操作”插件执行其他账号下的DRS任务时，需要提前创建委托和创建凭证，其步骤如下： 委托方账号创建委托并授权，授予被委托账号所需 IAM 和RDS的权限。 IAM所需最小权限策略如下： { "Version": "1.1", "Statement": [{ "Action": [ "iam:projects:listProjects" ], "Effect": "Allow" }] } DRS所需最小权限策略如下： { "Version": "1.1", "Statement": [ { "Effect": "Allow", "Action": [ "drs:migrationJob:get", "drs:migrationJob:action", "drs:migrationJob:delete" ] } ] } 被委托账号创建凭证，“委托账号”和“委托名”根据1配置。

跨账号执行DRS任务 当前账号通过“DRS检查任务方向和状态”插件执行其他账号下的DRS任务时，需要提前创建委托和创建凭证，其步骤如下： 委托方账号创建委托并授权，授予被委托账号所需IAM和RDS的权限。 IAM所需最小权限策略如下： { "Version": "1.1", "Statement": [{ "Action": [ "iam:projects:listProjects" ], "Effect": "Allow" }] } DRS所需最小权限策略如下： { "Version": "1.1", "Statement": [ { "Effect": "Allow", "Action": [ "DRS ReadOnlyAccess" ] } ] } 被委托账号创建凭证，“委托账号”和“委托名”根据1配置。

配置介绍 表1 选择输入-配置说明 参数 配置说明 任务所在region 选择任务所在区域。 凭证 选择凭证，默认显示当前命名空间多活分区下已配置的默认凭证。 项目 选择项目，默认显示当前命名空间多活分区下已配置的默认项目。 任务 选择DRS任务。 预期任务方向 选择“本云为主/出云”或“本云为备/入云”。 预期任务状态 选择“灾备中/增量开始”或“灾备异常/增量失败”。 说明： 仅支持输入INCRE_TRANSFER_STARTED或INCRE_TRANSFER_FAILED，INCRE_TRANSFER_STARTED表示灾备中或增量开始，INCRE_TRANSFER_FAILED表示灾备异常或增量失败 任务名称 请自定义输入任务名称。 表2 手动输入-配置说明 参数 配置说明 任务所在region 配置任务所在区域。 项目ID 配置项目ID。 凭证ID （可选）配置委托用户名。 说明： 不填写委托时：默认使用当前凭证。 使用委托时：委托用户名/委托名称/委托项目ID需要同时填写。 委托项目ID （可选）配置委托项目ID。 任务ID 输入DRS任务ID。 预期任务方向 输入“本云为主/出云”或“本云为备/入云”。 预期任务状态 输入“灾备中/增量开始”或“灾备异常/增量失败”。 说明： 仅支持输入INCRE_TRANSFER_STARTED或INCRE_TRANSFER_FAILED，INCRE_TRANSFER_STARTED表示灾备中或增量开始，INCRE_TRANSFER_FAILED表示灾备异常或增量失败 任务名称 请自定义输入任务名称。

配置介绍 表1 选择输入-配置说明 参数 配置说明 任务所在region 选择任务所在区域。 凭证 选择凭证，默认显示当前命名空间多活分区下已配置的默认凭证。 项目 选择项目，默认显示当前命名空间多活分区下已配置的默认项目。 任务 选择DRS任务。 对象级对比 选择“关闭”或“开启”。 说明： 数据对比和对象对比必须要有一个开启。 对比类型 选择对象。 数据级对比 选择“关闭”或“开启”。 说明： 数据对比和对象对比必须要有一个开启。 对比类型 选择行数对比或内容对比。 说明： 对象级对比开启或者任务类型规模非大规格、任务引擎为DDM，不能选择内容对比。 对象选择 请选择对比对象。 任务名称 请自定义输入任务名称。 表2 手动输入-配置说明 参数 配置说明 任务所在region 配置任务所在区域。 项目ID 配置项目ID。 凭证ID （可选）配置委托用户名。 说明： 不填写委托时：默认使用当前凭证。 使用委托时：委托用户名/委托名称/委托项目ID需要同时填写。 委托项目ID （可选）配置委托项目ID。 任务ID 输入DRS任务ID。 对象级对比 输入“关闭”或“开启”。 说明： 数据对比和对象对比必须要有一个开启。 对比类型 输入对象。 数据级对比 输入“关闭”或“开启”。 说明： 数据对比和对象对比必须要有一个开启。 对比类型 选择行数对比或内容对比。 说明： 对象级对比开启或者任务类型规模非大规格、任务引擎为DDM，不能选择内容对比。 对象选择 请选择对比对象。 任务名称 请自定义输入任务名称。

跨账号执行DRS任务 当前账号通过“DRS数据级/对象级对比”插件执行其他账号下的DRS任务时，需要提前创建委托和创建凭证，其步骤如下： 委托方账号创建委托并授权，授予被委托账号所需IAM和RDS的权限。 IAM所需最小权限策略如下： { "Version": "1.1", "Statement": [{ "Action": [ "iam:projects:listProjects" ], "Effect": "Allow" }] } DRS所需最小权限策略如下： { "Version": "1.1", "Statement": [ { "Effect": "Allow", "Action": [ "drs:disasterRecoveryJob:get", "drs:migrationCompareJob:start", "drs:migrationCompareJob:create", "drs:migrationCompareJob:delete", "drs:migrationJob:get3", "drs:compareJob:list", "drs:compareJob:getResult" ] } ] } 被委托账号创建凭证，“委托账号”和“委托名”根据1配置。

请求示例 创建一个应用模板，应用图标存储地址为空，添加应用模板标签，key为“ief-application-type”，value为“test”。 { "app" : { "name" : "ief-application-test", "alias" : "test", "description" : "This is an application test", "icon_url" : null, "tags" : [ { "key" : "ief-application-type", "value" : "test" } ] } }

响应示例 状态码： 201 ok { "app" : { "name" : "test-app-1", "icon_url" : null, "created_at" : "2018-05-26T08:41:33", "visibility" : null, "alias" : null, "project_id" : "{project_id}", "id" : "6c2c5f97-5c1d-408e-a0ee-c35c287afefe", "description" : "test", "app_versions" : [ ] } }