매개변수를 사용하여 QR 코드 생성
매개변수로 QR 코드 생성
사용자 채널 프로모션 분석 및 사용자 계정 바인딩과 같은 시나리오 요구 사항을 충족하기 위해 공개 플랫폼은 매개 변수를 사용하여 QR 코드를 생성하기 위한 인터페이스를 제공합니다. 이 인터페이스를 사용하면 서로 다른 장면 값을 가진 여러 개의 QR 코드를 얻을 수 있으며, 이를 스캔한 후 공개 계정은 이벤트 푸시를 받을 수 있습니다.
현재 2가지 유형의 QR 코드가 있습니다.
1. 임시 QR 코드에는 만료 시간이 있습니다. QR 코드가 생성된 후 30일(예: 2592000초)에 만료되도록 설정할 수 있지만 더 많은 수량을 생성할 수 있습니다. 임시 QR 코드는 QR 코드의 영구 저장이 필요하지 않은 계정 바인딩과 같은 비즈니스 시나리오에 주로 사용됩니다. 2. 영구 QR 코드는 만료 시간이 없지만 개수가 적습니다(현재 최대 100,000개). 영구 QR 코드는 주로 계정 바인딩 및 사용자 소스 통계와 같은 시나리오에 사용됩니다.
사용자가 공식 계정을 팔로우한 경우 사용자는 스캔 후 자동으로 세션에 들어가고 WeChat도 장면 값과 함께 스캔 이벤트를 개발자에게 푸시합니다.
매개변수가 포함된 QR 코드를 얻는 과정은 먼저 QR 코드 티켓을 생성한 다음 지정된 URL에 대한 티켓을 사용하여 QR 코드로 교환하는 과정으로 구성됩니다.
QR코드 티켓 생성
QR코드 티켓을 생성할 때마다 개발자가 설정한 매개변수(scene_id)를 제공해야 합니다. 임시 QR코드와 영구 QR코드에 대한 QR코드 티켓을 생성하는 과정은 다음과 같습니다. 각각 소개되었습니다.
임시 QR 코드 요청 지침
http 요청 방법: POST
URL: https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token=TOKENPOST 데이터 형식: json
POST 데이터 예: {"expire_seconds": 604800, "action_name": "QR_SCENE", "action_info": {"scene": {"scene_id": 123}}}
영구 QR 코드 요청 지침
http 요청 방법: POST
URL: https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token=TOKENPOST 데이터 형식: json
POST 데이터 예 : {"action_name": "QR_LIMIT_SCENE", "action_info": {"scene": {"scene_id": 123}}}
또는 다음 POST 데이터를 사용하여 문자열 형식의 QR 코드 매개변수를 생성할 수도 있습니다. :
{" action_name": "QR_LIMIT_STR_SCENE", "action_info": {"scene": {"scene_str": "123"}}}
매개변수 설명
| 매개변수 | 설명 |
|---|---|
| expire_seconds | 이 QR 코드의 유효 시간(초)입니다. 최대값은 2592000(즉, 30일)을 초과할 수 없습니다. 이 필드를 채우지 않으면 기본 유효 기간은 30초입니다. |
| action_name | QR 코드 유형, QR_SCENE은 임시, QR_LIMIT_SCENE은 영구, QR_LIMIT_STR_SCENE은 영구 문자열 매개변수 값 |
| action_info | QR 코드 세부정보 |
| scene_id | 장면 값 ID는 32입니다. -bit 임시 QR 코드의 경우 0이 아닌 정수이고 영구 QR 코드의 최대값은 100000입니다(현재 매개변수는 1--100000만 지원합니다) |
| scene_str | Scene 값 ID(문자열 형식의 ID) , string 유형, 길이 제한은 1~64이며, 영구 QR 코드만 이 필드를 지원합니다 |
반환 지침
올바른 Json 반환 결과:
{"ticket":"gQH47joAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL2taZ2Z3TVRtNzJXV1Brb3ZhYmJJAAIEZ23s UwME mm
3sUw==","expire_seconds":60,"url":"http://weixin.qq. com/q/kZgfwMTm72WWPkovabbI"}
| 매개변수 | 설명 |
|---|---|
| ticket | 획득한 QR코드 티켓으로, 유효시간 내에 QR코드로 교환할 수 있습니다. |
| expire_seconds | 이 QR 코드의 유효 시간(초)입니다. 최대값은 2,592,000(예: 30일)을 초과할 수 없습니다. |
| url | QR 코드 이미지가 구문 분석된 후의 주소입니다. 개발자는 이 주소를 기반으로 필요한 QR 코드 이미지를 생성할 수 있습니다. 티켓을 통해 QR 코드 교환 개발자는 QR 코드 티켓을 획득한 후 티켓을 사용하여 QR 코드 이미지로 교환할 수 있습니다. 이 인터페이스는 로그인하지 않고도 호출할 수 있습니다. 요청 설명 HTTP GET 요청(https 프로토콜을 사용하세요) https://mp.weixin.qq.com /cgi-bin/showqrcode?ticket=TICKET 알림: TICKET UrlEncode를 수행하는 것을 잊지 마세요 반환 지침 ticket 올바른 경우에는 http 리턴코드는 200 이며 직접 표시하거나 다운로드할 수 있는 사진입니다. HTTP 헤더(예)는 다음과 같습니다. 오류(불법 티켓 등)가 발생한 경우 HTTP 오류 코드 404는 돌아왔다. |
