기본 사용자 정보 획득(UnionID 메커니즘)


기본 사용자 정보 가져오기(UnionID 메커니즘)

1474939643359104.png

공식 계정은 팔로어의 OpenID(암호화된 WeChat ID)를 얻을 수 있습니다. 각 공식 계정에 대한 각 사용자의 OpenID는 고유합니다. 동일한 사용자라도 다릅니다). 공식 계정은 이 인터페이스를 사용하여 OpenID를 기반으로 닉네임, 아바타, 성별, 도시, 언어 및 팔로우 시간을 포함한 기본 사용자 정보를 얻을 수 있습니다.

개발자가 여러 공식 계정 간 또는 공식 계정과 모바일 애플리케이션 간 사용자 계정을 통합해야 하는 경우 WeChat 오픈 플랫폼(open.weixin.qq.com)으로 이동하여 공식 계정만 연결해야 합니다. 그러면 UnionID 메커니즘을 사용하여 위의 요구 사항을 충족할 수 있습니까?

UnionID 메커니즘 설명:

개발자는 OpenID를 통해 기본 사용자 정보를 얻을 수 있습니다. 특히 주의할 점은 개발자가 다수의 모바일 애플리케이션, 웹사이트 애플리케이션, 공개 계정을 보유하고 있는 경우, 동일한 WeChat 하의 모바일 애플리케이션이라면 사용자의 기본 정보에서 Unionid를 획득하여 사용자를 고유하게 구별할 수 있다는 점입니다. 개방형 플랫폼 계정, 웹사이트 애플리케이션 및 공개 계정에서 사용자의 유니온 ID는 고유합니다. 즉, 동일한 사용자의 경우 동일한 WeChat 오픈 플랫폼의 다양한 애플리케이션에 대해 Unionid가 동일합니다.

기본 사용자 정보 얻기(UnionID 메커니즘 포함)

개발자는 OpenID를 통해 기본 사용자 정보를 얻을 수 있습니다. https 프로토콜을 사용해 주세요.

인터페이스 호출 요청 설명

http 요청 방법: GET https://api.weixin.qq.com/cgi-bin/user/info?access_token=ACCESS_TOKEN&openid=OPENID&lang=zh_CN

매개변수 설명

현재 공개 계정에 대한 일반 사용자 식별 lang No국가 및 지역 언어 버전으로 돌아가기, zh_CN 단순화, zh_TW 전통, en 영어

반환 지침

일반적인 상황에서 WeChat은 다음 JSON 데이터 패킷을 공개 계정에 반환합니다:

{
"subscribe": 1,
"openid": "o6_bmjrPTlm6_2sgVt7hMZOPfL2M",
"nickname": "Band",
"sex": 1,
"언어": "zh_CN",
"city": "광저우",
"province": "광동",
"country": "중국",

"headimgurl": " http://wx.qlogo.cn/mmopen/g3MonUZtNHkdmzicIlibx6iaFqAc56vxLSUfpb6n5WKSYVY0ChQKkiaJSgQ1dZuTOgvLLrhJbERQQ4

eMsv84eavHiaiceqxibJxCfHe/0",

"subscribe_time": 1 382694957,
"unionid": " o6_bmasdasdsad6_2sgVt7hMZOPfL"
"remark": "",

"groupid": 0,

"tagid_list":[128,2]

}

매개변수 설명

매개변수 가 필수인가요? 설명
access_token호출 인터페이스 자격 증명
openid 입니다.
매개변수 설명
subscribe 사용자가 공식 계정 ID에 가입하는지 여부입니다. 값이 0이면 사용자가 공식 계정을 팔로우하지 않으며 다른 정보를 얻을 수 없음을 의미합니다.
openid현재 공개 계정에 고유한 사용자 식별자
nickname사용자의 닉네임
sex사용자의 성별, 값이 1이면 남성, 값이 2이면 여성, 값이 0이면 알 수 없음
city사용자가 위치한 도시
country사용자가 위치한 국가
지방사용자가 위치한 지역
언어사용자의 언어, 중국어 간체 zh_CN
headimgurl 사용자 아바타이며, 마지막 값은 정사각형 아바타 크기를 나타냅니다(0이 있습니다) , 46, 64, 96, 132 값을 사용할 수 있으며, 0은 640*640 정사각형 아바타를 나타냅니다), 사용자에게 아바타가 없는 경우 이 항목은 null입니다. 사용자가 아바타를 변경하면 원래 아바타 URL은 유효하지 않게 됩니다.
subscribe_time사용자가 주목하는 시간이 타임스탬프입니다. 사용자가 여러 번 팔로우한 경우 마지막 팔로우 시간
unionid은 사용자가 공식 계정을 WeChat 오픈 플랫폼 계정에 바인딩한 후에만 표시됩니다.
remark공용 계정 운영자가 팬에게 보내는 발언. 공용 계정 운영자는 WeChat 공개 플랫폼 사용자 관리 인터페이스에서 팬에게 댓글을 추가할 수 있습니다.
groupid사용자가 위치한 그룹 ID(이전 버전과 호환 가능) 사용자 그룹 인터페이스)
tagid_list사용자가 태그한 태그 ID 목록

WeChat은 오류 발생 시 오류 코드 및 기타 정보를 반환합니다. JSON 데이터 패킷 예는 다음과 같습니다(이 예는 잘못된 AppID 오류입니다):

{"errcode":40013,"errmsg":"invalid appid"}

사용자 기본 정보 일괄 가져오기

개발자는 이 인터페이스를 통해 기본 사용자 정보를 일괄적으로 얻을 수 있습니다. 한 번에 최대 100개 항목 가져오기를 지원합니다.

인터페이스 호출 요청 설명

http 요청 방법: POST

https://api.weixin.qq.com/cgi-bin/user/info/batchget?access_token=ACCESS_TOKEN

POST 데이터 예

{
"user_list": [
"{
"openid": "otvxTs4dckWG7imySrJd6jSi0CWE",
"lang": "zh-CN"
},
                                                                      lang": "zh-CN"
}
]
}

매개변수 설명

lang에 고유한 사용자의
매개변수 가 필수인가요? 설명
openid는 현재 공개 계정
식별자입니다. 아니요 국가 및 지역 언어 버전 , zh_CN 중국어 간체, zh_TW 중국어 번체, en 영어, 기본값은 zh-CN

반환 지침

정상적인 상황에서 WeChat은 다음 JSON 데이터 패킷을 공개 계정에 반환합니다(예에서는 openid 사용자 2명의 기본 정보를 한 번에 가져오고 첫 번째 정보를 따르고 두 번째 정보는 팔로우 안함):

{
"user_info_list": [
" {
" "구독": 1,
" openid": "otvxTs4dckWG7imySrJd6jSi0CWE",
"nickname": "iWithery",
"sex": 1,
"언어": "zh_CN",
"도시": "Jieyang",
"지방": "광동",
"국가": "중국",

"headimgurl": "http://wx.qlogo. cn/ mmopen/xbIQx1GRqdvyqkMMhEaGOX802l1CyqMJNgUzKP8MeAeHFicRDSnZH7FY4XB7p8XHXIf6uJA2SCun

TPicGKezDC4saKISzRj3nz/0",

"subscribe_time": 14340930 47,
"unionid": "oR5GjjgEhCMJFyzaVZdrxZ2zRRF4",
"비고": "",

"groupid": 0,

"tagid_list" :[1 28 . jrbqBZbrnPwwmSxFukE41U",
}

]
}

매개변수 설명

매개변수 설명
subscribe 사용자가 공식 계정 ID를 구독하는지 여부입니다. 값이 0이면 해당 사용자가 공식 계정을 팔로우하지 않는다는 의미이며 다른 정보를 가져올 수 없습니다. . openid 및 UnionID만 해당(이 공식 계정은 WeChat 오픈 플랫폼 계정에 연결된 경우에만 사용 가능)
openid현재 공개 계정에 고유한 사용자 식별자
nickname사용자의 닉네임
sex사용자의 성별, 값이 1이면 남성, 값이 2이면 여성, 값이 0이면 알 수 없음
city사용자가 위치한 도시
country사용자가 위치한 국가
지방사용자가 위치한 지역
언어사용자의 언어, 중국어 간체 zh_CN
headimgurl 사용자 아바타이며, 마지막 값은 정사각형 아바타 크기를 나타냅니다(0이 있습니다) , 46, 64, 96, 132 값을 사용할 수 있으며, 0은 640*640 정사각형 아바타를 나타냅니다), 사용자에게 아바타가 없는 경우 이 항목은 null입니다. 사용자가 아바타를 변경하면 원래 아바타 URL은 유효하지 않게 됩니다.
subscribe_time사용자가 주목하는 시간이 타임스탬프입니다. 사용자가 여러 번 팔로우한 경우 마지막 팔로우 시간
unionid은 사용자가 공식 계정을 WeChat 오픈 플랫폼 계정에 바인딩한 후에만 표시됩니다.
remark공개 계정 운영자가 팬에게 보내는 발언. 공개 계정 운영자는 WeChat 공개 플랫폼 사용자 관리 인터페이스에서 팬에게 발언을 추가할 수 있습니다.
groupid사용자가 위치한 그룹 ID(일시적으로 호환 가능) 기존 사용자 그룹) 인터페이스)
tagid_list사용자가 태그한 태그 ID 목록

WeChat은 오류 발생 시 오류 코드 및 기타 정보를 반환합니다. JSON 데이터 패킷 예는 다음과 같습니다(이 예는 잘못된 AppID 오류입니다):

{"errcode":40013,"errmsg":"invalid appid" }
ㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋ