기본 사용자 정보 획득(UnionID 메커니즘)
기본 사용자 정보 가져오기(UnionID 메커니즘)
공식 계정은 팔로어의 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
매개변수 설명
매개변수 | 가 필수인가요? | 설명 |
access_token | 은 | 호출 인터페이스 자격 증명 |
openid | 입니다. | 현재 공개 계정에 대한 일반 사용자 식별|
No | 국가 및 지역 언어 버전으로 돌아가기, zh_CN 단순화, zh_TW 전통, en 영어 |
매개변수 | 설명 |
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 오류입니다):
사용자 기본 정보 일괄 가져오기
개발자는 이 인터페이스를 통해 기본 사용자 정보를 일괄적으로 얻을 수 있습니다. 한 번에 최대 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"
}
]
}
매개변수 설명
매개변수 | 가 필수인가요? | 설명 |
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 오류입니다):