[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"
]
}
]
}
}
~~~
