支付寶小程序API 圖片內(nèi)容安全

2020-09-16 15:50 更新

my.ap.imgRisk

版本需求:基礎(chǔ)庫 1.14.0 或更高版本,若版本較低,建議做 兼容處理。

圖片風(fēng)險(xiǎn)任務(wù)提交接口,用于識(shí)別圖片是否有色情、違禁違法等內(nèi)容。有關(guān)圖片內(nèi)容安全的產(chǎn)品和接入介紹。

接口說明

此接口為異步請(qǐng)求接口,首先需要發(fā)起風(fēng)險(xiǎn)識(shí)別請(qǐng)求,獲取任務(wù) ID。等待 500 毫秒(ms)后再通過任務(wù) ID 請(qǐng)求結(jié)果。

1. 調(diào)用參數(shù)說明

  • 通過傳輸圖片內(nèi)容判斷此圖片信息中是否包含風(fēng)險(xiǎn)信息,圖片需要傳輸U(kuò)RL。
  • 圖片必須是公網(wǎng)可以訪問的圖片,如果有加密或者限權(quán),則無法返回結(jié)果。

2. 返回參數(shù)說明

  • REJECTED:拒絕,代表此圖片風(fēng)險(xiǎn)程度高,不能發(fā)布展示。
  • PASSED:通過,代表此圖片的風(fēng)險(xiǎn)程度低,可以發(fā)布展示。

3. 圖片風(fēng)險(xiǎn)任務(wù)提交

示例代碼

my.ap.imgRisk
  ({pid:'xxxxxxxxxxxxxxxx',  
    appId:'xxxxxxxxxxxxxxxx',  
    bizContext:
    {"risk_type":"img_risk",
     "content": "http://www.xxxxxx.com.cn//xxxxxx/xxxxxxx/images/xxxx/xx/xxx.png"
    },
  success(e) {
  },
})

入?yún)?/h3>

Object 類型,屬性如下:

屬性 類型 必填 描述
pid String 合作者身份 ID。即商戶與支付寶簽約后,商戶獲得的支付寶商戶唯一識(shí)別碼。
appId String 小程序的 APPID。
bizContext Map 需要識(shí)別的業(yè)務(wù)參數(shù)。
success Function 調(diào)用成功的回調(diào)函數(shù)。
fail Function 調(diào)用失敗的回調(diào)函數(shù)。
complete Function 調(diào)用結(jié)束的回調(diào)函數(shù)(調(diào)用成功、失敗都會(huì)執(zhí)行)。

bizContext 屬性說明

屬性 類型 必填 最大長度 描述 示例值
risk_type String 1024 風(fēng)險(xiǎn)類型。 固定傳 img_risk
content String 128 需要驗(yàn)證的圖片 URL。 https://ss1.bdstatic.com/70cFvXSh_Q1YnxGkpoWK1HF6hhy/it/u=3180559933,1841450308&fm=26&gp=0.jpg

success 回調(diào)函數(shù)

Object 類型,屬性如下:

屬性 類型 最大長度 描述 示例值
riskResult String 128 圖片風(fēng)險(xiǎn)識(shí)別的任務(wù)的任務(wù)ID。 \"apply_id\":\"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\
riskResultDesc String 1024 風(fēng)險(xiǎn)識(shí)別結(jié)果描述。 返回結(jié)果會(huì)默認(rèn)為空,忽略即可
success Boolean - 是否調(diào)用成功。 true
uniqueId String 1024 業(yè)務(wù)唯一識(shí)別碼。 xxxxxxxxxxxxxxxxx

fail 回調(diào)函數(shù)

Object 類型,屬性如下:

屬性 類型 描述
errorCode String 錯(cuò)誤碼。
errorMessage String 錯(cuò)誤信息。

my.ap.imgRiskCallback

版本需求:基礎(chǔ)庫 1.14.0 或更高版本,若版本較低,建議做 兼容處理。

查詢圖片的風(fēng)險(xiǎn)識(shí)別結(jié)果。有關(guān)圖片內(nèi)容安全的產(chǎn)品和接入介紹。

接口說明

此接口為異步請(qǐng)求接口。首先需要發(fā)起風(fēng)險(xiǎn)識(shí)別請(qǐng)求,獲取任務(wù) ID,等待 500 毫秒(ms)后再通過任務(wù) ID 請(qǐng)求結(jié)果。

1. 調(diào)用參數(shù)說明

  • 通過傳輸圖片內(nèi)容判斷此圖片信息中是否包含風(fēng)險(xiǎn)信息,圖片需要傳輸 URL。
  • 圖片必須是公網(wǎng)可以訪問的圖片,如果有加密或者限權(quán),則無法返回結(jié)果。

2. 返回參數(shù)說明

  • REJECTED:拒絕,代表此圖片風(fēng)險(xiǎn)程度高,不能發(fā)布展示。
  • PASSED:通過,代表此圖片的風(fēng)險(xiǎn)程度低,可以發(fā)布展示。

示例代碼

my.ap.imgRiskCallback
    ({pid:'xxxxxxxxxxxxxxxx',  
        appId:'xxxxxxxxxxxxxxxx',  
        bizContext:{
            "risk_type": "img_risk_result",
            "apply_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
    },
  success(e) {
  },
})

入?yún)?/h3>

Object 類型,屬性如下:

屬性 類型 必填 描述
pid String 小程序的開放平臺(tái)賬號(hào)。
appId StringArray 小程序?qū)?yīng)的 APPID。
bizContext Map 需要識(shí)別的業(yè)務(wù)參數(shù)。
success Function 調(diào)用成功的回調(diào)函數(shù)。
fail Function 調(diào)用失敗的回調(diào)函數(shù)。
complete Function 調(diào)用結(jié)束的回調(diào)函數(shù)(調(diào)用成功、失敗都會(huì)執(zhí)行)。

bizContext 屬性說明

參數(shù) 類型 必填 最大長度 描述 示例值
risk_type String 1024 風(fēng)險(xiǎn)類型。 固定傳 img_risk_result
apply_id String 128 需要查詢圖片的任務(wù) ID。 2eee1a72-4f32-45d6-bfa3-0f7173cde80b

success 回調(diào)函數(shù)

Object 類型,屬性如下:

參數(shù) 類型 最大長度 描述 示例值
riskResult String 128 圖片風(fēng)險(xiǎn)識(shí)別的任務(wù)的任務(wù) ID。 \"action\":\"REJECTED\" \"action\":\"PASSED\"
riskResultDesc String 1024 風(fēng)險(xiǎn)識(shí)別結(jié)果描述。 \"REJECTED\":\"攔截\" \"PASSED\":\"放過\
success Boolean - 是否調(diào)用成功。 true
uniqueId String 1024 業(yè)務(wù)唯一識(shí)別碼 0b92uueie87636222

fail 回調(diào)函數(shù)

Object 類型,屬性如下:

屬性 類型 描述
errorCode String 錯(cuò)誤碼。
errorMessage String 錯(cuò)誤信息。

常見問題

報(bào)錯(cuò)說明

錯(cuò)誤碼(errorMessage) 錯(cuò)誤明細(xì) 解決方案
serviceNoAuth 服務(wù)未授權(quán)。 請(qǐng)檢查配置的賬戶是否已簽約響應(yīng)的功能包。
riskTypeNoAuth 場(chǎng)景(risktype)未授權(quán)。 請(qǐng)檢查配置的賬戶是否已簽約響應(yīng)的功能包,請(qǐng)檢查 risktype 參數(shù)是否正確。
bizContentEmpty 風(fēng)險(xiǎn)數(shù)據(jù)內(nèi)容為空。 檢查入?yún)?shù)據(jù)格式。
paramMissingError 參數(shù)缺失。 檢查必傳參數(shù)是否傳入。
param error 參數(shù)錯(cuò)誤。 檢查入?yún)⒏袷绞欠穹衔臋n要求。
SYSTEM_OUT_ERROR 系統(tǒng)繁忙。 請(qǐng)稍后再試。
INVALID_PARAMETER 缺少必選參數(shù)或參數(shù)有誤。 檢查參數(shù)是否正確或者缺失。
OVER_LIMIT 超過調(diào)用量限制。 如需增加額度,請(qǐng)發(fā)郵件至 RiskGoCSC@service.alipay.com 進(jìn)行申請(qǐng)。

Q:沒有返回識(shí)別結(jié)果該怎么處理?

A:確認(rèn)風(fēng)險(xiǎn)識(shí)別的任務(wù) ID,為此圖片對(duì)應(yīng)的任務(wù) ID。

500ms 后若返回空,建議等待 500ms 后重試。一共重試 3 次,若全為空,嘗試重新提交審核任務(wù)。

Q:圖片說明格式以及大???

A:

圖片格式支持:BMP, PNG, JPEG, TIFF, SVG, ICO

圖片大?。?~10MB

圖片的 URL 需要可訪問。如果出現(xiàn)無法訪問,下載失敗,非圖片格式會(huì)返回通過。

Q:調(diào)用頻率是怎樣的?

A:不要并發(fā)調(diào)用。

以上內(nèi)容是否對(duì)您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)