通用场景
申请获取接口出参中用户敏感信息字段,应用使用视频或图片(至少选择一项上传),单个图片或视频不超过10m,最多可上传5张图片示例。
公共请求参数
业务请求参数
auth_field_apply必选authfieldapply
【描述】字段申请表单,其中api_name,field_name,package_code三个字段参数通过alipay.open.app.api.query接口查询获得,scene_code 则可通过alipay.open.app.api.scene.query接口查询获得。
api_name必选string(255)
【描述】接口英文名称,通过alipay.open.app.api.query接口查询获得。
【示例值】alipay.user.info.share
field_name必选string(255)
【描述】字段英文名称,通过alipay.open.app.api.query接口查询获得。
【示例值】mobile
package_code必选string(255)
【描述】功能code,通过alipay.open.app.api.query接口查询获得
【示例值】20201019201538211864
scene_code必选string(255)
【描述】场景code,alipay.open.app.api.scene.query 接口查询获得
【示例值】6
qps_answer必选string(2048)
【描述】接入后一年内预计接口秒级调用量峰值是多少?(最高峰值:1000qps)
【示例值】预计接口秒级调用量峰值:xx qps
customer_answer必选string(2048)
【描述】贵公司是否有自己的客服渠道,能及时响应和处理舆情数量是多少?
【示例值】有自己的客服团队xx人,能够及时响应并处理舆能力
memo可选string(2048)
【描述】备注
【示例值】获取xx的用途:(1)xxxx(2)xxxx
tiny_app_template_id可选string(255)
【描述】当为使用使用模板的小程序申请时可传入所使用的小程序模板id
【示例值】小程序模板id
video可选byte[](10485750)
【描述】请上传应用使用视频,必须包括如何登录、如何授权输出此字段、如何使用等内容。视频支持格式:mp4,视频不超过10m。
video或picture_x不可同时为空,至少需传入1个。
【示例值】xxx.mp4
picture_1可选byte[](10485750)
【描述】请上传应用使用图片必须包括如何登录、如何授权输出此字段、如何使用等内容。图片支持格式:png,jpg,jpeg,图片不超过10m。
video或picture_x不可同时为空,至少需传入1个。
【示例值】review_pic1.png
picture_2可选byte[](10485750)
【描述】请上传应用使用图片必须包括如何登录、如何授权输出此字段、如何使用等内容。图片支持格式:png,jpg,jpeg,图片不超过10m。
video或picture_x不可同时为空,至少需传入1个。
【示例值】review_pic2.png
picture_3可选byte[](10485750)
【描述】请上传应用使用图片必须包括如何登录、如何授权输出此字段、如何使用等内容。图片支持格式:png,jpg,jpeg,图片不超过10m。
video或picture_x不可同时为空,至少需传入1个。
【示例值】review_pic3.png
picture_4可选byte[](10485750)
【描述】请上传应用使用图片必须包括如何登录、如何授权输出此字段、如何使用等内容。图片支持格式:png,jpg,jpeg,图片不超过10m。
video或picture_x不可同时为空,至少需传入1个。
【示例值】review_pic4.png
picture_5可选byte[](10485750)
【描述】请上传应用使用图片必须包括如何登录、如何授权输出此字段、如何使用等内容。图片支持格式:png,jpg,jpeg,图片不超过10m。
video或picture_x不可同时为空,至少需传入1个。
【示例值】review_pic5.png
常见请求示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.open.app.api.field.apply&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
-f 'app_auth_token=${app_auth_token}' \
-f 'video=@/home/admin/test.jpg' \
-f 'picture_1=@/home/admin/test.jpg' \
-f 'picture_2=@/home/admin/test.jpg' \
-f 'picture_3=@/home/admin/test.jpg' \
-f 'picture_4=@/home/admin/test.jpg' \
-f 'picture_5=@/home/admin/test.jpg' \
-f 'auth_field_apply={
"package_code":"20201019201538211864",
"qps_answer":"预计接口秒级调用量峰值:xx qps",
"tiny_app_template_id":"小程序模板id",
"api_name":"alipay.user.info.share",
"memo":"获取xx的用途:(1)xxxx(2)xxxx",
"scene_code":"6",
"field_name":"mobile",
"customer_answer":"有自己的客服团队xx人,能够及时响应并处理舆能力"
}'
说明:本示例仅供参考。
公共响应参数
业务响应参数
无业务响应参数
响应示例
正常示例
异常示例
{
"alipay_open_app_api_field_apply_response": {
"code": "10000",
"msg": "success"
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}
说明:本示例仅供参考。
公共错误码
业务错误码
错误码 | 错误描述 | 凯发app官方网站的解决方案 |
---|---|---|
system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常,导致服务调用失败,商户可以用同样的请求发起重试 |
account_type_error | 账号类型错误 | 字段仅支持企业账号和个体工商户,请检查商户支付宝账号类型 |
api_name_error | 功能中未包含申请敏感字段的接口名称 | 请确保添加功能中包含申请的接口名称 |
api_name_is_blank | 接口英文名称为空 | 请填写接口英文名称 |
app_id_is_blank | 应用id为空 | 请填写应用id |
app_info_not_exist | 应用信息不存在 | 请检查应用信息 |
authfieldapply_is_blank | 申请信息为空 | 请填写申请信息 |
auth_api_apply_is_pass | 字段申请已通过请勿重复申请 | 请检查应用是否已提交过申请,若应用申请在已通过则无法发起申请。 |
auth_api_field_is_auditing | 字段申请审核中请勿重复申请 | 请检查应用是否已提交过申请,若应用申请在审核中则无法发起申请。 |
auth_api_field_is_blank | 申请字段信息为空 | 请检查字段名称与alipay.open.app.api.query接口查询结果一致 |
auth_field_scene_is_blank | 场景信息为空 | 请检查调用时传入场景编码,且编码与alipay.open.app.api.scene.query接口查询结果一致 |
biz_error | 业务异常业务异常 | 联系技术排查 |
customer_answer_is_blank | 客服评估为空 | 请填写客服评估 |
field_name_is_blank | 字段名称为空 | 请填写字段名称 |
file_format_is_invalid | 文件格式错误 | 请检查文件格式 |
file_items_is_blank | 示例图片及视频不能都为空 | 请至少上传一个文件 |
file_quality_is_invalid | 上传的图片清晰度不足 | 请重新拍照上传 |
file_size_min_limit | 上传的文件过小 | 请检查文件大小 |
file_size_out_limit | 上传文件过大 | 请检查文件大小 |
package_code_error | 应用功能不存在 | 请检查应用是否已添加功能 |
package_code_is_blank | 功能编码为空 | 请填写功能编码,确保与alipay.open.app.api.query接口查询结果一致 |
privacy_field_not_exist | 没有此隐私字段 | 请检查隐私字段名称与alipay.open.app.api.query接口查询结果一致 |
qps_answer_is_blank | qps评估为空 | 请填写qps评估 |
scene_code_error | 场景编码非法 | 请检查场景编码与alipay.open.app.api.scene.query接口查询结果一致 |
scene_code_is_blank | 场景编码为空 | 请填写场景编码 |
show_package_is_blank | 应用功能为空 | 请在开放平台应用详情页中为应用添加功能 |
tinyapp_health_check_invalid | 小程序健康分校验失败 | 请提高小程序健康分 |
tinyapp_safety_check_invalid | 小程序安全分校验失败 | 请提高小程序安全分 |
user_id_no_permission | 用户无应用操作权限 | 请检查用户是否为应用所有者 |