[TOC]
### 接口说明
> 此接口接收一个图像，该图像被用于检查是否与已知的儿童色情或虐待数据相匹配。
> 现有数据库提供方：
> * 美国失踪和受虐儿童中心（NCMEC）
> * 非政府组织联盟（包括加拿大儿童保护中心）
> * 互联网观察基金会（IWF）
> * 美国技术联盟
> * 加拿大工业
> 以后将增加更多来源。
### 请求Url
`[POST] https://api-westus.microsoftmoderator.com/v1/ScanImage/Validate[?CacheImage]`
### 请求参数
| 字段 | 类型 | 描述 |
| -- | -- | -- |
| CacheImage (可选) | boolean | 是否保留已提交的图像以供将来使用；如果省略，默认为False |
### 请求头部(headers)
| 字段 | 类型 | 描述 |
| -- | -- | -- |
| Content-Type (可选) | string | 发送到API的媒体类型。 |
| Ocp-Apim-Subscription-Key | string | 提供访问该接口的订阅密钥。在您的个人资料中可以找到。 |
### 请求体(body)
> 请求的Body可以是一个图像；或是下面支持的MIME类型
> * Content-Type: image/gif
> * Content-Type: image/jpeg
> * Content-Type: image/png
> * Content-Type: image/bmp
> * Content-Type: image/tiff
>
> 另外：可以使用公开访问的URL图像（GIF，JPEG，PNG，BMP，或TIFF），在后面的例子中提供演示（Content-Type：application/json）；
> ~~~
> {
> "DataRepresentation": "URL",
> "Value": "https://pdnasampleimages.blob.core.windows.net/matchedimages/img_130.jpg"
> }
> ~~~
> 另外，服务响应时间可能受限于外部资源的下载速度，从而产生不利影响。
### 响应码200
| 字段 | 描述 |
| -- | -- |
| Status | 状态码和对应说明：<br>3000：正常<br>3002：请求参数无效或缺失<br>3004：未知的情况下或未处理的错误在处理请求<br>3206：给定的文件不能被验证为图像 |
| TrackingId | 个人请求的唯一ID标识 |
| IsMatch | 布尔值，该值指示提交的图像是否匹配一个已知的图像 |
| MatchDetails | matchflags的合集。<br>matchflag：提交图像匹配了指定源的已知图像。<br>注意：提交的图像跟多个来源相匹配。 |
~~~
{
"Status": {
"Code": 3000,
"Description": "OK",
"Exception": null
},
"TrackingId": "WUS_399b38b6-ee1e-45eb-a216-a420ce8171a9_photodna_d8ea7ca9a72548489cfb4e8a359c1ea6",
"ContentId": null,
"IsMatch": true,
"MatchDetails": {
"AdvancedInfo": [],
"MatchFlags": [
{
"AdvancedInfo": [
{
"Key": "MatchId",
"Value": "117721"
}
],
"Source": "TEST",
"Violations": [
"A1"
]
}
]
}
}
~~~
