支付宝小游戏-内容安全识别对接文档

文档修订记录

版本	更新日期	更新内容
3.1.1	2024.12.09	提供支付宝小游戏的文本内容安全识别接口

1. 支付宝小游戏的文本内容安全识别接口

1.1 说明

目前支持了支付宝平台中游戏内容的文本内容安全识别，具体接入找平台协助处理。

1.2 Api地址

地址: https://api-combine.feiyu.com/v1/alipayMiniGame/contentSpam/text/check

1.3 请求方式

POST

1.4 请求头

"Content-type":"application/json"

1.5 请求参数

请求示例：

{
    "app_id": "30035",
    "open_id": "0498313ebb8b0e43a585e9ffc1700821",
    "products": "TJ_POLITICS_MC",
    "channel": "miniappcloud",
    "content_type": "TEXT",
    "data_list": ["习大大"],
    "sign": "838d7d32c014e87377a7837091952994",
    "sign_nonce": "aUptFmUa",
    "sign_version": "1.1",
    "timestamp": "1725261770"
}

参数名	必选	类型	说明
app_id	是	string	应用ID
open_id	是	string	用户的聚合openID（不是微信openID）
products	是	string	服务产品码列表，不同客户可能存在差异，按实际检测需求传值即可，当前支持的检测服务码：TJ_POLITICS_MC：敏感；TJ_PORN_MC：色情；TJ_ILLEGAL_MC：违禁；TJ_TERRORISM_MC：暴恐，TJ_ABUSES_MC：谩骂，其他需求请与蚂蚁内容安全客户经理沟通获取
channel	是	number	来源渠道，按照实际申请开通的产品权限相应传值： Riskgo内容风险识别：tinyapp-eco-open 小程序云内容风险识别：miniappcloud（文本），miniappcloud-oss（图片OSS）数科内容风险识别：digital-tech（数科生产），digital-tech-poc（数科POC）
content_type	是	string	送检内容类型枚举值：图片:PICTURE，文本:TEXT
data_list	是	array	用户发表内容，建议对内容中的格式符号、表情符、HTML标签、UBB标签等做过滤，只传递纯文本，以减少误判（当前仅支持单图调用，多图调用待后续升级使用），当前接口仅支持单一内容传入。
timestamp	是	string	10位时间戳
sign	是	string	签名值
sign_type	是	string	签名类型(默认：md5)
sign_nonce	是	string	签名随机数(随机数字+字符串共8位)
sign_version	是	string	固定值：1.1

1.6 返回参数

返回实例：

{
    "trace_id": "5c3b5d1572d57da8dfa5a34d317c4daf",
    "status": 0,
    "message": "OK",
    "data": {
        "request_id": "5c3b5d1572d57da8dfa5a34d317c4daf",
        "result_code": "OK",
        "result_msg": "SUCCESS",
        "suggestion": "block",
        "meter_products": "TJ_POLITICS_MC",
        "is_sync": false,
        "detect_check_labels": [
            {
                "label": "",
                "rate": "0.0",
                "sub_check_labels": {
                    "hit_strategy": 0,
                    "sub_label": "",
                    "rate": ""
                }
            },
            {
                "label": "",
                "rate": "0.0",
                "sub_check_labels": {
                    "hit_strategy": 0,
                    "sub_label": "",
                    "rate": ""
                }
            },
            {
                "label": "",
                "rate": "0.0",
                "sub_check_labels": {
                    "hit_strategy": 0,
                    "sub_label": "",
                    "rate": ""
                }
            },
            {
                "label": "100",
                "rate": "95.0",
                "sub_check_labels": {
                    "hit_strategy": 0,
                    "sub_label": "",
                    "rate": ""
                }
            }
        ]
    }
}

通用参数

参数名	类型	说明
trace_id	string	请求唯一ID
status	int	状态码, 0代表成功，非0状态码可参考如下错误码表格确认信息
message	string	返回结果描述

数据参数

参数名	类型	说明
request_id	string	请求ID
result_code	string	业务返回结果码
result_msg	string	返回结果信息
suggestion	string	处置建议： pass:通过 block:拦截 review:复核
meter_products	string	计量产品
is_sync	bool	是否同步返回
detect_check_labels	[]object	风险识别标签内容
detect_check_labels[n].label	string	一级风险分类信息
detect_check_labels[n].rate	string	分值
detect_check_labels[n].sub_check_labels	object	子分类信息
detect_check_labels[n].sub_check_labels.hit_strategy	int	机器审核内容的类型：0:图片内容,1:图片上的文字
detect_check_labels[n].sub_check_labels. sub_label	string	二级子分类，详细编码请与蚂蚁内容安全客户经理沟通获取
detect_check_labels[n].sub_check_labels. rate	string	置信度分数：0-100之间取值，100为置信度最高，0为置信度最低

公共错误码

https://opendoc.alipay.com/common/02km9f

业务错误码

错误码	错误描述	解决方案
SYSTEM_ERROR	系统繁忙	服务器异常可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试
INVALID_PARAMETER	参数有误	请根据接口返回的参数非法的具体错误信息，修改参数后进行重试

2 签名规则

2.1 MD5签名

2.1.1、获取基础接入参数

在【对接中心->渠道打包->配置参数】，：App ID（请求参数app_id）和App Secret（签名密钥）。

file

2.1.1、签名文档

参考：鉴权指南md5 - v1.1