History
Introduction
API Category
Making API Requests
Region APIs
Instance APIs
Cloud Hosting Cluster APIs
Image APIs
Instance Launch Template APIs
Placement Group APIs
Key APIs
Security Group APIs
Network APIs
Data Types
Error Codes
ci:CreateMediaJobs in the authorization policy. For all operation APIs supported by Cloud Infinite, please refer to action.cam:PassRole permission for role passing, making it easy for the asynchronous processing API to perform read and write operations on COS resource through CAM's "role".POST /jobs HTTP/1.1Host: <BucketName-APPID>.ci.<Region>.myqcloud.comDate: <GMT Date>Authorization: <Auth String>Content-Length: <length>Content-Type: application/xml<body>
<Request><Tag>ImageLicenseRec</Tag><Input><Object>input/test.doc</Object></Input><Operation><ImageLicenseRec><CardType>IDCard</CardType></ImageLicenseRec><UserData>This is my data.</UserData><JobLevel>0</JobLevel></Operation><CallBack>http://callback.demo.com</CallBack><CallBackFormat>JSON</CallBackFormat></Request>
Node Name (Keyword) | Parent Node | Description | Type | Required |
Request | None | Container for saving requests | Container | Yes |
Node Name (Keyword) | Parent Node | Description | Type | Required |
Tag | Request | Tag for creating a task: ImageLicenseRec | String | Yes |
Input | Request | Object information to be operated | Container | Yes |
Operation | Request | Operation rules | Container | Yes |
CallBackFormat | Request | Task callback format, JSON or XML, default XML, which has a higher priority than the callback format of the queue | String | No |
CallBackType | Request | Task callback type, URL or TDMQ, default URL, which has a higher priority than the callback type of the queue | String | No |
CallBack | Request | Task callback address, which has a higher priority than the callback address of the queue. When set to "no", the callback address will not trigger a callback. | String | No |
CallBackMqConfig | Request | Task callback TDMQ configuration, required when CallBackType is TDMQ. For details, see CallBackMqConfig. | Container | No |
Node Name (Keyword) | Parent Node | Description | Type | Required |
Object | Request.Input | File path | String | Yes |
Node Name (Keyword) | Parent Node | Description | Type | Required |
ImageLicenseRec | Request.Operation | Card OCR task parameters | Container | Yes |
UserData | Request.Operation | Pass through user information in printable ASCII code, with length not exceeding 1024 | String | No |
JobLevel | Request.Operation | Task priority, level limit: 0, 1, 2. Higher level indicate higher task priority, default is 0. | String | No |
Node Name (Keyword) | Parent Node | Description | Type | Required |
CardType | Request.Operation.ImageLicenseRec | Card OCR type, value is: IDCard: refers to identity card DriverLicense: refers to driving license | String | Yes |
<Response><JobsDetail><Code>Success</Code><Message/><JobId>ac7c990a00bf211ed946af9e0691f2b7a</JobId><State>Submitted</State><CreationTime>2022-06-27T14:44:10+0800</CreationTime><StartTime>-</StartTime><EndTime>-</EndTime><QueueId>pcd463e1467964d39ad2d3f66aacd8199</QueueId><Tag>ImageLicenseRec</Tag><Input><BucketId>test-123456789</BucketId><Object>input/test.jpg</Object><Region>ap-chongqing</Region></Input><Operation><ImageLicenseRec><CardType>IDCard</CardType></ImageLicenseRec><ImageLicenseRecResult><Code>Success</Code><State>Success</State><InputObjectName>input/test.jpg</InputObjectName><InputObjectUrl>https://test-123456789.cos.ap-chongqing.myqcloud.com/input/test.jpg</InputObjectUrl><Status>1</Status><IdInfo><Name>Name</Name><DetectedText>xxx</DetectedText><Score>99</Score><Location><Point>553,439</Point><Point>553,576</Point><Point>989,576</Point><Point>989,439</Point></Location></IdInfo><IdInfo><Name>Gender</Name><DetectedText>Male</DetectedText><Score>98</Score><Location><Point>541,597</Point><Point>541,723</Point><Point>798,723</Point><Point>798,597</Point></Location></IdInfo><IdInfo><Name>Ethnicity</Name><DetectedText>Han</DetectedText><Score>98</Score><Location><Point>1032,599</Point><Point>1032,725</Point><Point>1265,725</Point><Point>1265,599</Point></Location></IdInfo><IdInfo><Name>Birth (Date)</Name><DetectedText>December 1, 1974</DetectedText><Score>99</Score><Location><Point>532,748</Point><Point>532,906</Point><Point>1346,906</Point><Point>1346,748</Point></Location></IdInfo><IdInfo><Name>Address</Name><DetectedText>Hu’nan Province xxxxx</DetectedText><Score>99</Score><Location><Point>534,931</Point><Point>534,1253</Point><Point>1587,1253</Point><Point>1587,931</Point></Location></IdInfo><IdInfo><Name>Identification Number (ID Number)</Name><DetectedText>43xxxx</DetectedText><Score>99</Score><Location><Point>842,1372</Point><Point>842,1615</Point><Point>2284,1615</Point><Point>2284,1372</Point></Location></IdInfo><ImageLicenseRecResult><UserData>This is my data.</UserData><JobLevel>0</JobLevel></Operation></JobsDetail></Response>
Node Name (Keyword) | Parent Node | Description | Type |
Response | None | Container for saving results | Container |
Node Name (Keyword) | Parent Node | Description | Type |
JobsDetail | Response | Task detailed information | Container |
Node Name (Keyword) | Parent Node | Description | Type |
Code | Response.JobsDetail | Error code, which takes effect when State is Failed | String |
Message | Response.JobsDetail | Error description, which takes effect when State is Failed | String |
JobId | Response.JobsDetail | ID of the newly created task | String |
Tag | Response.JobsDetail | Tag for the newly created task: ImageOCR | String |
State | Response.JobsDetail | Task status, which can be one of the following: Submitted, Running, Success, Failed, Pause, Cancel | String |
CreationTime | Response.JobsDetail | Task creation time | String |
StartTime | Response.JobsDetail | Task start time | String |
EndTime | Response.JobsDetail | Task end time | String |
QueueId | Response.JobsDetail | Queue ID of the task | String |
Input | Response.JobsDetail | Same as Request.Input in the request | Container |
Operation | Response.JobsDetail | Operation rule | Container |
Node Name (Keyword) | Parent Node | Description | Type |
ImageLicenseRec | Response.JobsDetail.Operation | Same as Request.Operation.ImageLicenseRec in the request | Container |
ImageLicenseRecResult | Response.JobsDetail.Operation | Card OCR result | Container |
UserData | Response.JobsDetail.Operation | Pass through user information | String |
JobLevel | Response.JobsDetail.Operation | Task priority | String |
Node Name (Keyword) | Parent Node | Description | Type |
State | Response.JobsDetail.Operation.ImageLicenseRecResult | Current node's task status, either Success or Failed | Container |
Code | Response.JobsDetail.Operation.ImageLicenseRecResult | Error code, which takes effect when State is Failed | Container |
Message | Response.JobsDetail.Operation.ImageLicenseRecResult | Error description, which takes effect when State is Failed | Container |
InputObjectName | Response.JobsDetail.Operation.ImageLicenseRecResult | Current node's input object name | String |
InputObjectUrl | Response.JobsDetail.Operation.ImageLicenseRecResult | Current node's input object URL | String |
Status | Response.JobsDetail.Operation.ImageLicenseRecResult | Card OCR result 1: Result is detected 0: No result is detected | String |
IdInfo | Response.JobsDetail.Operation.ImageLicenseRecResult | Card OCR information | Container |
Node Name (Keyword) | Parent Node | Description | Type |
Name | Response.JobsDetail.Operation.ImageLicenseRecResult.IdInfo | Field name | String |
Score | Response.JobsDetail.Operation.ImageLicenseRecResult.IdInfo | Confidence degree of the field, value range: [0-100], the higher the value, the higher the probability | Integer |
Location | Response.JobsDetail.Operation.ImageLicenseRecResult.IdInfo | Coordinate of the field | Container |
DetectedText | Response.JobsDetail.Operation.ImageLicenseRecResult.IdInfo | Field content | String |
Node Name (Keyword) | Parent Node | Description | Type |
Point | Response.JobsDetail.Operation.ImageLicenseRecResult.IdInfo.Location | Coordinate point (X coordinate, Y coordinate) | String |
POST /jobs HTTP/1.1Authorization: q-sign-algorithm=sha1&q-ak=AKIDZfbOAo7cllgPvF9cXFrJD0a1ICvR****&q-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=28e9a4986df11bed0255e97ff90500557e0ea057Host: test-1234567890.ci.ap-beijing.myqcloud.comContent-Length: 166Content-Type: application/xml<Request><Tag>ImageLicenseRec</Tag><Input><Object>input/test.jpg</Object></Input><Operation><ImageLicenseRec><CardType>IDCard</CardType></ImageLicenseRec><UserData>This is my data.</UserData><JobLevel>0</JobLevel></Operation><CallBack>http://callback.demo.com</CallBack><CallBackFormat>JSON</CallBackFormat></Request>
HTTP/1.1 200 OKContent-Type: application/xmlContent-Length: 230Connection: keep-aliveDate: Mon, 28 Jun 2022 15:23:12 GMTServer: tencent-cix-ci-request-id: NTk0MjdmODlfMjQ4OGY3XzYzYzhf****<Response><JobsDetail><Code>Success</Code><Message/><JobId>ac7c990a00bf211ed946af9e0691f2b7a</JobId><State>Submitted</State><CreationTime>2022-06-27T14:44:10+0800</CreationTime><StartTime>-</StartTime><EndTime>-</EndTime><QueueId>pcd463e1467964d39ad2d3f66aacd8199</QueueId><Tag>ImageLicenseRec</Tag><Input><BucketId>test-123456789</BucketId><Object>input/test.jpg</Object><Region>ap-chongqing</Region></Input><Operation><ImageLicenseRec><CardType>IDCard</CardType></ImageLicenseRec><ImageLicenseRecResult><Code>Success</Code><State>Success</State><InputObjectName>input/test.jpg</InputObjectName><InputObjectUrl>https://test-123456789.cos.ap-chongqing.myqcloud.com/input/test.jpg</InputObjectUrl><Status>1</Status><IdInfo><Name>Name</Name><DetectedText>xxx</DetectedText><Score>99</Score><Location><Point>553,439</Point><Point>553,576</Point><Point>989,576</Point><Point>989,439</Point></Location></IdInfo><IdInfo><Name>Gender</Name><DetectedText>Male</DetectedText><Score>98</Score><Location><Point>541,597</Point><Point>541,723</Point><Point>798,723</Point><Point>798,597</Point></Location></IdInfo><IdInfo><Name>Ethnicity</Name><DetectedText>Han</DetectedText><Score>98</Score><Location><Point>1032,599</Point><Point>1032,725</Point><Point>1265,725</Point><Point>1265,599</Point></Location></IdInfo><IdInfo><Name>Birth (Date)</Name><DetectedText>December 1, 1974</DetectedText><Score>99</Score><Location><Point>532,748</Point><Point>532,906</Point><Point>1346,906</Point><Point>1346,748</Point></Location></IdInfo><IdInfo><Name>Address</Name><DetectedText>Hu’nan Province xxxxx</DetectedText><Score>99</Score><Location><Point>534,931</Point><Point>534,1253</Point><Point>1587,1253</Point><Point>1587,931</Point></Location></IdInfo><IdInfo><Name>Identification Number (ID Number)</Name><DetectedText>43xxxx</DetectedText><Score>99</Score><Location><Point>842,1372</Point><Point>842,1615</Point><Point>2284,1615</Point><Point>2284,1372</Point></Location></IdInfo><ImageLicenseRecResult><UserData>This is my data.</UserData><JobLevel>0</JobLevel></Operation></JobsDetail></Response>
フィードバック