查询用户是否已经关注了生活号 -凯发app官方网站

支持第三方代理调用

更新时间：2024-05-31 16:47:28

我的文档

设置

注意：本文档为单篇api文档，可能无法实现整体功能，强烈不建议单独使用该文档进行能力接入。如需查找完整的接入文档，请前往或者使用

通用场景

查询用户是否已经关注生活号，支持生活号、内容号、财富号

公共请求参数

参数	类型	是否必选	最大长度	描述	示例值
app_id	string	必选	32	支付宝分配给开发者的应用id	2014072300007148
method	string	必选	128	接口名称	alipay.open.public.user.follow.query
format	string	可选	40	仅支持json	json
charset	string	必选	10	请求使用的编码格式，如utf-8,gbk,gb2312等	utf-8
sign_type	string	必选	10	商户生成签名字符串所使用的签名算法类型，目前支持rsa2和rsa，推荐使用rsa2	rsa2
sign	string	必选	344	商户请求参数的签名串，详见签名	详见示例
timestamp	string	必选	19	发送请求的时间，格式"yyyy-mm-dd hh:mm:ss"	2014-07-24 03:07:50
version	string	必选	3	调用的接口版本，固定为：1.0	1.0
app_auth_token	string	可选	40	详见应用授权概述
biz_content	string	必选		请求参数的集合，最大长度不限，除公共参数外所有请求参数都必须放在这个参数中传递，具体参照各产品快速接入文档

业务请求参数

以下参数二选一传入

user_idstring(32)

【描述】支付宝用户id，用户在支付宝的唯一标识，以 2088 开头的 16 位纯数字组成。

新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认应用-开发配置-openid配置管理已启用。无该配置项，可查看openid配置申请。

【示例值】2088132324342243

open_idstring(128)

【描述】支付宝用户唯一的标识详情可查看 openid简介

【示例值】074a1cctg1lelxke4xqc0zgndid0nxi95b5lsnpazwyoco5

参数	类型	是否必选	最大长度	描述	示例值
user_id	string	二选一	32	支付宝用户id，用户在支付宝的唯一标识，以 2088 开头的 16 位纯数字组成。新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认应用-开发配置-openid配置管理已启用。无该配置项，可查看openid配置申请。	2088132324342243
open_id	string	128	支付宝用户唯一的标识详情可查看 openid简介	074a1cctg1lelxke4xqc0zgndid0nxi95b5lsnpazwyoco5

常见请求示例

默认示例

curljavac#php

curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.open.public.user.follow.query&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
 -f 'biz_content={
	"user_id":"2088132324342243",
	"open_id":"074a1cctg1lelxke4xqc0zgndid0nxi95b5lsnpazwyoco5"
}'

说明：本示例仅供参考。

公共响应参数

参数	类型	是否必选	最大长度	描述	示例值
code	string	必选	-	网关返回码,	40004
msg	string	必选	-	网关返回码描述,	business failed
sub_code	string	可选	-	业务返回码，参见具体的api接口文档	acq.trade_has_success
sub_msg	string	可选	-	业务返回码描述，参见具体的api接口文档	交易已被支付
sign	string	必选	-	签名,	dzxh8eetuahoye3w1j poiphfdxoybfunn1lket/v7p4zjdyojwea6izs6hz0ydw5cp/viufub5i0/v5wens3oyr8zredqo6d futdlhdc efyckiqhbxizgngpdpdfp1pis7bdhhzrszhbrqb7o4k3dxc aanfauu4v6zdwczo=

业务响应参数

is_follow必选string(1)

【描述】用户是否关注。枚举值如下： *t：代表已关注。 *f：代表未关注。

【示例值】t

参数	类型	是否必选	最大长度	描述	示例值
is_follow	string	必选	1	用户是否关注。枚举值如下： t：代表已关注。 f：代表未关注。	t

响应示例

正常示例

异常示例

{
    "alipay_open_public_user_follow_query_response": {
        "code": "10000",
        "msg": "success",
        "is_follow": "t"
    },
    "sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}

说明：本示例仅供参考。

公共错误码

业务错误码

错误码	错误描述	凯发app官方网站的解决方案
system_error	系统繁忙	服务器异常可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试
invalid_parameter	参数有误	请根据接口返回的参数非法的具体错误信息，修改参数后进行重试
business_error	系统业务处理错误	请检查输入参数是否正确，或者稍后重试
illegal_biz_params	无效的业务参数	检查业务参数是否合法

设置阅读模式