文本内容安全接口文档

更新时间：2019/06/13 访问次数：3198

1. 服务说明

1) 服务适用场景

基于深度学习及AI文本审核技术，一站式帮助客户识别文本中夹杂的色情、违禁违法等垃圾内容，净化网络环境，提升客户平台的内容质量，而且能大幅度降低人工审核成本。

2) 服务调用方式

环境	HTTPS请求地址
正式环境	https://openapi.alipay.com/gateway.do

3) 服务申请前的准备工作

有效的APPID：您需提供一个有效的应用ID（APPID）来调用此服务，您可前往

https://openhome.alipay.com/platform/appManage.htm#/apps生成一个专属应用，

或使用现有的APPID来申请此服务。

2. 接口说明

1) 接口名称

alipay.security.risk.customerrisk.query

2) 参数说明

1、调用参数说明

通过传输文本内容判断此文本信息中是否包含风险信息，信息直接按文本进行传输即可。

2、返回参数说明

风险类型说明：

MYDDS_BKZ：暴恐政；
MYDDS_EROTICISM：色情；
MYDDS_ABUSE：辱骂；
MYDDS_ILLEGAL_ADVERT：违规广告；
MYDDS_ADVERT：广告；

会针对每种风险类型返回高中低三种风险识别结果

3) 业务请求参数

参数	类型	是否必填	最大长度	描述	示例值
service	String	是	128	合作伙伴匹配服务类型,请按照示例值填写	固定content_risk_lite
risk_type	String	是	1024	风险类型	固定传content_risk
content	String	是	2048	需要验证的文本内容	小明是个好孩子

4) 技术请求参数

参数	类型	是否必填	最大长度	描述	示例值
app_id	String	是	32	支付宝分配给开发者的应用ID	2014072300007148
method	String	是	128	接口名称	alipay.security.risk.customerrisk.query
format	String	否	40	仅支持JSON	JSON
charset	String	是	10	请求使用的编码格式，如utf-8,gbk,gb2312等	utf-8
sign_type	String	是	10	商户生成签名字符串所使用的签名算法类型，目前支持RSA/RSA2。推荐使用RSA2	RSA2
sign	String	是	256	商户请求参数的签名串，详见（https://docs.open.alipay.com/200/105351）	详见示例
timestamp	String	是	19	发送请求的时间，格式"yyyy-MM-dd HH:mm:ss"	2014-07-24 03:07:50
version	String	是	3	调用的接口版本，固定为：1.0	1.0
notify_url	String	否	256	支付宝服务器主动通知商户服务器里指定的页面http/https路径。	http://api.test.alipay.net/atinterface/receive_notify.htm
app_auth_token	String	否	40	详见应用授权概述（https://docs.open.alipay.com/common/105193）
biz_content	String	是	-	请求参数的集合，最大长度不限，除公共参数外所有请求参数都必须放在这个参数中传递，具体参照各产品快速接入文档

5) 业务返回参数

参数

类型

是否必填

最大长度

描述

示例值

risk_result

String

是

128

风险分析结果，返回针对用户拒付场景下返回的风险值

\"risk_level \":\"HIGH\"\"label\":\"色情\"

risk_result_desc

String

是

1024

风险结果分析返回值

\"HIGH\":\"高风险 \"

6) 技术返回参数

参数	类型	是否必须	最大长度	描述	示例值
code	String	是	～	网关返回码，详见文档 : https://docs.open.alipay.com/common/105806	40004
msg	String	是	～	网关返回码描述，详见文档 : https://docs.open.alipay.com/common/105806	Business Failed
sub_code	String	否	～	网关明细返回码，详见文档 : https://docs.open.alipay.com/common/105806	isv.invalid-signature
sub_msg	String	否	～	网关明细返回码描述，详见文档 : https://docs.open.alipay.com/common/105806	交易已被支付
sign	String	是	64	签名，详见文档 :hhttps://docs.open.alipay.com/common/105806

7) 代码样例

请求示例

{
    "biz_content": {
        "service": "content_risk_lite", 
        "risk_type": "content_risk", 
        "content": "法轮功"
    }
}

响应示例

{
    "alipay_security_risk_customerrisk_query_response": {
        "code": "10000", 
        "msg": "Success", 
        "risk_result_desc": "{\"HIGH\":\"高风险\",\"MYDDS_BKZ\":\"暴恐政\",\"LOW\":\"低风险\",\"MYDDS_EROTICISM\":\"色情\"}", 
        "risk_result": "{\"56816d00f71c44bd43902e1abf72566c\":\"[{\\\\\"risk_level\\\\\":\\\\\"HIGH\\\\\",\\\\\"label\\\\\":\\\\\"MYDDS_BKZ\\\\\"},{\\\\\"risk_level\\\\\":\\\\\"LOW\\\\\",\\\\\"label\\\\\":\\\\\"MYDDS_EROTICISM\\\\\"}]\"}"
    }, 
    "sign": "SHOctfCKXBPs3Z/2CMmOchokTrMRYAVqXqAnnn9ju8ls6/+zQaE2ls+9JdP7rvADU+gNKhWQkbyevEJeSg3Xn4mnBCboyG0BELVZfpNHPU5nVfdgHMNZmwO8NvLkj6mx7UzWlVucU3Km7fwgtFYjxA5O9ozekLDANSbjO7dbqDJVhj7REqrLbuP97zgQh8wb6XqoEx5ywTEr30+PYGvGkV8JjJtQuSZEjo2oh8Q8ilAURI0r2wDKpxepZ+tvWk5HEngxex9e7cFNzlid4IU2GVQuyKiB6jzoGxTWeYY6vrPpGV6rEOEV+1ncVafdCg/gg7nP091VMCJ+AABNkz28kw=="
}

8）识别结果反馈

接口说明：针对蚂蚁内容安全识别的文本结果进行标记回传，用于提升模型能力，定制化为客户输出风险识别能力。

接口名称：alipay.security.risk.customerrisk.send

业务参数:

参数	中文名称	类型	是否必填	最大长度	描述	示例值
pid	合作伙伴支付宝账户ID	string	是	128	合作伙伴支付宝账户ID	20887766626322
service	反馈服务名称	string	是	128	反馈服务名称	固定传content_risk_lite
risk_type	反馈风险类型	string	是	128	反馈风险类型	固定传content_risk
process_code	处理类型	string	是	2	处理类型	固定传11
content	风险识别内容	string	是	2048	进行风险识别的内容	小明是个好孩子
content_feedback	内容反馈结果	string	是	128	客户针对内容的反馈： 01--正常 02--暴恐政 03--色情 04--人身攻击、辱骂 05-- 营销广告 06--其他 07--垃圾帖	01
alipay_detect_result	蚂蚁识别结果	string	是	128	蚂蚁针对此段内容回传的结果	{[{\\\\\"risk_level\\\\\":\\\\\"HIGH\\\\\", \\\\\"label\\\\\":\\\\\"MYDDS_BKZ\\\\\"}, {\\\\\"risk_level\\\\\":\\\\\"LOW\\\\\", \\\\\"label\\\\\":\\\\\"MYDDS_EROTICISM\\\\\"}]\"}" }

8) 报错说明

错误码	错误描述	解决方案
BIZ_ERROR	业务异常服务没有被授权，比如虽然已经签约query服务，但是没有被授权查询商户综合风险，出这个异常	联系商户服务团队，在服务申请页面中申请此细项服务的授权
INVALID_PARAMETER	参数有误没有按照要求进行参，比如要求mobile_no，但是输入了mobile	请查看接口文档，查看参数是否正确配置
SYSTEM_ERROR	系统繁忙	内部系统分析超时，请给出时间，以及入参，联系BD，进行内部分析
MISSING_REQUIRED_ARGUMENTS	参数有误缺少必选参数	请查看接口文档，查看参数是否配置正确。

3. 常见问题

FAQ

关于此文档暂时还没有FAQ

有用(0) 我要提问

开放平台

RiskGo安全合作平台文档