在做园区、商场或写字楼的WiFi覆盖项目时，经常要和统一认证平台、网管系统或IoT中台对接。比如想把AP在线状态、用户连接数、信号强度这些数据实时推到自己的运维大屏上，就得调用对方提供的API——但刚拿到接口文档，第一句就是‘需申请调用权限’，人就懵了：这权限到底找谁批？填什么表？多久能下来？
先搞清你在跟谁打交道
不是所有WiFi设备都开放接口。常见分三类：
• 华为eSight、H3C iMC这类网管平台，权限走内部IT流程，通常由客户信息科或网络中心审批；
• TP-Link Omada、Ubiquiti UniFi等商用方案，得登录厂商开发者后台注册应用，生成App ID和密钥；
• 一些定制化WiFi系统（比如学校自建的portal平台），往往需要联系原厂实施工程师，提供公司营业执照、项目合同号、调用用途说明才能开通。
一份真实用过的申请材料清单
上周帮一家连锁酒店申请WiFi探针数据接口，他们要求提交：
• 《API调用申请表》（盖公章，写明调用场景：如‘用于客房终端类型统计’）；
• 接口调用IP白名单（我们填了运维服务器的两个固定出口IP）；
• 开发者联系人姓名+手机号+邮箱（必须是企业邮箱）；
• 简单的技术方案说明（不用写代码，就说清楚‘每天拉取一次在线AP列表，存进MySQL做巡检报表’就行）。
权限开通后，第一步别急着写代码
拿到Client ID、Client Secret和Token地址后，先用curl测通：
curl -X POST https://api.wifi-platform.com/oauth/token \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "client_id=your_client_id" \
-d "client_secret=your_client_secret" \
-d "grant_type=client_credentials"返回{"access_token":"xxx","expires_in":3600}才算真正跑通。很多同事卡在这步，其实是填错了client_secret里的下划线，或者没注意token接口要求HTTPS且必须带Header。
特别提醒两个高频踩坑点
• 某些WiFi系统（比如部分锐捷AC）的接口权限是按功能模块分开授权的，申请‘设备状态查询’不等于能调‘用户日志下载’，得一项一项勾选；
• 权限开通后默认有QPS限制（比如5次/秒），如果要做全网AP批量轮询，得额外邮件申请提升配额，否则请求直接返回429 Too Many Requests。