Wi-Fi 장치 관리


비밀번호 유형 장치 추가

1475894603961331.png

이 인터페이스를 호출하면 비밀번호형 기기의 Wi-Fi 정보를 지정된 매장에 추가할 수 있습니다. 매장 내 여러 기기의 원활한 로밍을 보장합니다.

1. 최대 100개의 SSID를 추가할 수 있습니다. 추가된 SSID는

3. 스토어에는 하나의 장치 유형만 있을 수 있습니다. 이 인터페이스를 호출하여 ssid을 추가하세요. 비밀번호 유형 장치 이며 더 이상 을 추가할 수 없습니다 portal 유형 장치#🎜 🎜## 🎜🎜#. 저장소 지우기Wi-Fi정보 인터페이스clear the 네트워크 정보를 입력한 후 다른 유형의 장치로 설정할 수 있습니다.


참고:

다음 두 가지를 수행해야 합니다. 이 인터페이스를 호출한 후에는 이러한 단계를 거쳐야 장치가 공식적으로 활성화될 수 있습니다
1. 무선 라우터의 관리 배경으로 들어가 SSID 및 비밀번호를 수정합니다. 추가할 장치의 SSID와 비밀번호가 일치하는지 확인하세요. 비밀번호는 인터페이스 호출 시 입력한 비밀번호와 일치해야 합니다.


#🎜🎜 #2. 반드시 "

Get Material QR Code" 인터페이스를 호출하고, 매장의 QR 코드를 다운로드하여 매장에 게시하세요. 그리고 누군가(고객 또는 매장 직원)가 QR 코드를 스캔하여 Android 버전 6.1 이상용 WeChat 또는 IOS 버전 6.2.2 이상용 WeChat을 사용하여 Wi-Fi에 연결하는지 확인하세요. 연결에 성공하면 장치가 성공적으로 추가되었음을 의미합니다.


인터페이스 호출 설명

协议:https
http请求方式: POST
请求URL:https://api.weixin.qq.com/bizwifi/device/add?access_token=ACCESS_TOKEN
POST数据格式:JSON

#🎜 🎜#요청 매개변수 설명

Parameter필요합니까설명 # 🎜🎜#access_token입니다. # 🎜 🎜#POST 데이터은 JSON 데이터

POST 데이터

데이터 예:

{
  "shop_id": 429620,
  "ssid": "WX123",
  "password": "12345689",
}

필드 설명:

호출 인터페이스 자격 증명
Field필수인가요?설명
shop_id 스토어 ID
ssid 무선 네트워크 장치의 SSID입니다. ssid와 비밀번호 중 하나는 대문자 "WX"로 시작해야 하며 32자 이내여야 합니다. ssid는 중국어를 지원하지만, 기기 호환성 문제로 인해 문자가 깨져 표시되거나 연결되지 않을 수 있습니다. 위험!
password무선 네트워크 장치의 비밀번호입니다. 8-24자, 중국어 문자를 포함할 수 없습니다. ssid와 비밀번호 중 하나는 대문자 "WX"
로 시작해야 합니다.

반환 데이터 설명

올바른 JSON 데이터 반환 예:

{
  "errcode": 0
}


Note#🎜🎜 #: 장비 추가 후, 반드시 "Get Material QR Code" 인터페이스를 호출하여 매장 QR 코드를 다운로드하고 매장에 게시하세요. 그리고 누군가(고객 또는 매장 직원)가 Android 6.1 이상용 WeChat 또는 IOS 6.2.2 이상용 WeChat을 사용하여 QR 코드를 스캔하여 Wi-Fi에 연결되었는지 확인하세요. 연결에 성공하면 장치가 성공적으로 추가되었음을 의미합니다.


포털형 기기 추가

다음 인터페이스를 호출하여 포털 장치의 네트워크 정보를 추가합니다. 그리고 비밀키를 받으세요. Secretkey는 암호화된 문자열 매개변수이며 포털 장치 변환 프로세스에서 중요한 매개변수입니다. 비밀키 유출을 방지하기 위해 이 인터페이스를 통해 재설정하고 새로 고칠 수 있습니다. 재설정 후에는 이전에 생성된 비밀키가 무효화됩니다. 참고하세요 :

1 같은 매장에서 여러 개 추가 가능 ssid# 🎜 🎜#, 최대 추가 수100ssid;#🎜🎜 #

2

스토어에는 하나의 장치 유형만 있을 수 있습니다. 하나를 추가하려면 이 인터페이스를 호출하세요. ssid#🎜 🎜 # 이후 매장은 portal형 개조장비로 진행됩니다. 스토어 아래에 포털이 아닌 장치가 있는 경우 이 인터페이스를 호출할 수 없습니다. 인터페이스 호출 지침

协议:https
http请求方式: POST
请求URL:https://api.weixin.qq.com/bizwifi/apportal/register?access_token=ACCESS_TOKEN
POST数据格式:JSON

매개변수 설명 요청

입니다.
매개변수가 필수인가요?Description
access_token인터페이스 자격 증명 호출
POST 데이터 JSON 데이터

POST 데이터

데이터 예:

{
   "shop_id": 429620,
   "ssid": "WX123",
   "reset": false
}

필드 설명:

Field필수인가요?설명
shop_id 스토어 ID
ssid 무선 네트워크 장치의 SSID이며 30자로 제한됩니다. SSID는 중국어를 지원하지만, 기기 호환성 문제로 인해 문자가 깨져 표시되거나 연결이 되지 않을 수 있습니다. 이에 따른 책임은 귀하에게 있습니다!
resetNo비밀 키 재설정, false-no 재설정, true-reset, 기본값은 false

데이터 설명 반환

JSON 데이터 예:

{
   "errcode": 0,
   "data": {
     "secretkey": "1af08ec5cdb70a4d7365bcd64d3120f6"
   }
}

필드 설명:


필드 Description
secre tkey포털을 변환하는 데 필요한 매개변수 페이지, 이 매개변수는 WeChat
JSAPI 인터페이스의 부호 매개변수 값 계산을 트리거하는 데 사용됩니다.



참고:

장치를 추가한 후 인증 프로토콜 인터페이스에 따라 장치를 수정해야 합니다. 그렇지 않으면 Wi-Fi에 대한 WeChat 연결이 되지 않습니다. 가능한.

기기 쿼리


可通过指定分页或具体门店ID的方式,查询当前MP账号下指定门店连网成功的设备信息。一次最多能查询20个门店的设备信息。

接口调用说明

协议:https
http请求方式: POST
请求URL:https://api.weixin.qq.com/bizwifi/device/list?access_token=ACCESS_TOKEN
POST数据格式:JSON

매개변수 설명 요청

입니다.
매개변수가 필수인가요?Description
access_token인터페이스 자격 증명 호출
POST 데이터 JSON 데이터

POST 데이터

데이터 예:

分页查询时:
{
   "pageindex": 1,		
   "pagesize":10
}
根据门店ID查询时:
{
   "pageindex": 1,		
   "pagesize":10,
   "shop_id":429620
}

필드 설명:

부터 시작
Field필수인가요?Description
pageindexNo 페이지 아래 첨자, 기본값은 1
pagesizeNo페이지당 페이지 수, 기본값 10, 최대 20
shop_idNo스토어 ID 기준 쿼리

반환 데이터 설명

올바르게 반환된 JSON 데이터 예:

{
   "errcode": 0,
   "data": {
     "totalcount": 2,
     "pageindex": 1,
     "pagecount": 1,
     "records": [
       {
         "shop_id": 429620,
         "ssid": "WX123",
         "bssid": "00:1f:7a:ad:5b:a9",
         "protocol_type":4
       },
       {
         "shop_id": 429620,
         "ssid": "WX123",
         "bssid": "00:1f:7a:ad:5c:a8",
         "protocol_type":4
       }
     ]
   }
}

필드 설명:

# 🎜🎜#FieldDescriptiontotalcountTotalcount# 🎜 🎜 번호 페이지 매김 페이지 수records현재 페이지 목록 배열shop_id# 🎜🎜 ####상점 ID#### ## ## #####ssid#🎜🎜 ####연결된 장치 SSID

기기 삭제

bssid를 기준으로 스토어 아래의 단일 장치를 삭제합니다. 삭제 후, 가능한 한 빨리 기기의 네트워크 이름과 비밀번호를 변경하거나, 기기 사용을 중단하세요. 그렇지 않으면 기기가 자동으로 다시 추가됩니다. 매장 네트워크 및 모든 기기를 삭제해야 하는 경우 "매장 네트워크 및 기기 삭제" 인터페이스를 호출하세요.

인터페이스 호출 설명

协议:https
http请求方式: POST
请求URL:https://api.weixin.qq.com/bizwifi/device/delete?access_token=ACCESS_TOKEN
POST数据格式:JSON

요청 매개변수 설명

####### 🎜🎜#bssid무선 MAC 주소
protocol_type스토어에 있는 기기의 기기 유형, 0- 추가된 장치 없음, 4-비밀번호형 장치, 31-포털형 장치
매개변수 가 필수인가요? 설명
access_token인터페이스 자격 증명 호출
POST 데이터 JSON 데이터

POST 데이터

데이터 예:

{
  "bssid":"00:1f:7a:ad:5c:a8"
}

필드 설명:

Field필수인가요?Description
bssid 삭제해야 할 무선 MAC 주소 무선 네트워크 장치 형식은 콜론으로 구분되고 문자 길이는 17자이며 문자는 소문자입니다(예: 00:1f:7a:ad:5c:a8
).

반환 데이터 설명

JSON 데이터를 올바르게 반환하는 예:

{
   "errcode": 0
}