Gestion des appareils Wi-Fi


Ajouter un périphérique de code d'accès

1475894603961331.png

Appelez cette interface pour ajouter les informations Wi-Fi des appareils de type mot de passe au magasin désigné. Pour garantir une itinérance transparente de plusieurs appareils dans le magasin.

1. Vous pouvez ajouter plusieurs SSID au même magasin, avec un maximum de 100 SSID

2 Les SSID qui ont été ajoutés ne peuvent pas être ajoutés à nouveau ;

3. Un magasin ne peut avoir qu'un seul type d'appareil. Tant que vous appelez cette interface pour ajouter un ssid, le magasin sera un appareil de type mot de passe, et vous ne pourrez plus . ajoutez un appareil de type portail . Appelez Clear StoreWi-FiInterface d'informationAprès avoir effacé les informations du réseau, vous pouvez les configurer sur d'autres types d'appareils.


Remarque : Après avoir appelé cette interface, les deux étapes suivantes sont nécessaires pour activer officiellement l'appareil

1. Entrez l'arrière-plan de gestion du routeur sans fil et modifiez le SSID et le mot de passe de l'appareil à ajouter. Assurez-vous que le SSID et le mot de passe de l'appareil sont cohérents avec ceux renseignés lors de l'appel de l'interface

2. Assurez-vous d'appeler l'interface "Obtenir le code QR du matériel" pour télécharger le QR du magasin. code et affichez-le dans le magasin. Et assurez-vous que quelqu'un (client ou commis de magasin) scanne le code QR pour se connecter au Wi-Fi à l'aide de WeChat pour Android version 6.1 ou supérieure ou de WeChat pour IOS version 6.2.2 ou supérieure. Une connexion réussie signifie que l'appareil a été ajouté avec succès.


Description de l'appel d'interface

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

Description du paramètre de demande

Le paramètre est-il obligatoire ?Description
access_token est les informations d'identification de l'interface d'appel
Les données POST sontLes données JSON

Données POST

Exemple de données :

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

Description du champ :

ChampEst-ce obligatoire ?Description
shop_id est identifiant du magasin
ssid est le SSID du périphérique réseau sans fil. L'un des SSID et du mot de passe doit commencer par la lettre majuscule « WX » et contenir moins de 32 caractères ; le SSID prend en charge le chinois, mais il peut afficher des caractères tronqués ou ne pas pouvoir se connecter en raison de problèmes de compatibilité de l'appareil. Vous êtes responsable des éléments concernés. risques!
password est le mot de passe du périphérique réseau sans fil. 8-24 caractères ; ne peut pas contenir de caractères chinois ; l'un des identifiants et du mot de passe doit commencer par la lettre majuscule "WX"

Instructions pour le retour des données

Exemple de retour correct des données JSON :

{
  "errcode": 0
}


Remarque : Après avoir ajouté l'équipement, assurez-vous d'appeler l'interface "Obtenir le code QR du matériel" pour télécharger le code QR du magasin et publiez-le sur Inside the store. Et assurez-vous que quelqu'un (client ou commis de magasin) scanne le code QR pour se connecter au Wi-Fi à l'aide de WeChat pour Android version 6.1 ou supérieure ou de WeChat pour IOS version 6.2.2 ou supérieure. Une connexion réussie signifie que l'appareil a été ajouté avec succès.


Ajouter un périphérique de portail

Appelez l'interface suivante pour ajouter les informations réseau du périphérique portail et obtenir la clé secrète. Secretkey est un paramètre de chaîne chiffré et constitue un paramètre important dans le processus de transformation du périphérique de portail. Pour éviter les fuites de clé secrète, vous pouvez réinitialiser et actualiser via cette interface. Après la réinitialisation, la clé secrète précédemment générée deviendra invalide. Attention :

1. Vous pouvez ajouter plusieurs ssid au même magasin, avec un maximum de 100ssid

2 ; Un magasin uniquement Pour avoir un type d'appareil, tant que vous appelez cette interface pour ajouter un ssid, la boutique sera un appareil de transformation de type portal. S'il y a un appareil non-portail dans le magasin, cette interface ne peut pas être appelée.

Instructions d'appel de l'interface

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

Description du paramètre de demande

Le paramètre est-il obligatoire ?Description
access_tokenOuiIdentifiants d'appel
POST les données sont des données JSON

Données POST

Exemple de données :

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

Description du champ :

ChampEst-ce obligatoire ?Description
shop_id est identifiant du magasin
ssid est le SSID du périphérique réseau sans fil, limité à 30 caractères. SSID prend en charge le chinois, mais il peut afficher des caractères tronqués ou ne pas pouvoir se connecter en raison de problèmes de compatibilité des appareils. Vous êtes responsable des risques associés !
resetNonRéinitialiser la clé secrète, faux-pas de réinitialisation, vrai-réinitialisation, la valeur par défaut est fausse

Description des données de retour

Renvoyer correctement un exemple de données JSON :

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

Description du champ :


Champ Description
secre tkeyparamètres requis pour transformer le portail page, Ce paramètre permet de déclencher le calcul de la valeur du paramètre signe de l'interface JSAPI de WeChat



Remarque :

Après avoir ajouté l'appareil, assurez-vous de modifier l'appareil en fonction de l'Interface du protocole d'authentification, sinon la connexion WeChat au Wi-Fi ne sera pas possible.

Appareil de requête


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

接口调用说明

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

Description du paramètre de demande

Le paramètre est-il obligatoire ?Description
access_tokenOuiIdentifiants d'appel
POST les données sont des données JSON

Données POST

Exemple de données :

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

Description du champ :

ChampEst-ce obligatoire ?Description
pageindexNon Indice de page, la valeur par défaut commence à 1
pagesizeNonNombre de pages par page, par défaut 10, maximum 20
shop_idNonRequête basée sur l'identifiant du magasin

Description des données de retour

Renvoyer correctement un exemple de données 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
       }
     ]
   }
}

Description du champ :

ChampDescription
compte totalCompte total
index des pagesIndice des pages
pagecountnombre de pages de pagination
enregistrementstableau de liste des pages actuelles
shop_ididentifiant du magasin
ssidappareil connecté ssid
bssidAdresse MAC sans fil
protocol_typeLe type d'appareil de l'appareil dans le magasin, 0-aucun appareil ajouté, appareil à 4 mots de passe, appareil à 31 portails

Supprimer l'appareil

Supprimez un seul appareil sous le magasin en fonction du bssid. Après la suppression, veuillez modifier le nom de réseau et le mot de passe de l'appareil dès que possible, ou cesser d'utiliser l'appareil, sinon l'appareil sera automatiquement réajouté. Si vous devez effacer le réseau du magasin et tous les appareils, veuillez appeler l'interface « Effacer le réseau et les appareils du magasin ».

Description de l'appel d'interface

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

Description du paramètre de requête

Le paramètre est-il obligatoire ? Description
access_token est les informations d'identification de l'interface d'appel
Les données POST sont Données JSON

Données POST

Exemple de données :

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

Description du champ :

ChampEst-ce obligatoire ?Description
bssidOui Doit être supprimé L'adresse Mac sans fil de le périphérique réseau sans fil, le format est séparé par deux points, la longueur des caractères est de 17 et les lettres sont en minuscules, par exemple : 00:1f:7a:ad:5c:a8

Description des données de retour

Exemple de retour correct des données JSON :

{
   "errcode": 0
}