开发者指南-如何使用API鉴权-开发者指南-青果网络

为进一步提高使用代理IP的安全性、保密性，青果为广大开发者用户提供了API鉴权的功能。API鉴权启用后，就需先通过密码或白名单鉴权，才能顺利调用代理IP。

以下介绍如何使用API鉴权：

## 一、启用API鉴权

①进入青果控制台，选择要设置API鉴权的代理IP业务，点击其右侧的【更多】-【业务设置】-【API鉴权】选项；

![image-20240615171731438](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads%2Fimage%2F2024-06-15%2F171731f4034ca.png)

②点击【启用状态】右侧滑键，即可启用API鉴权功能。

在【鉴权设置】一行，可选择鉴权的方式是密码或白名单，若两者皆✔，则两种方式同时可用。

![image-20240615171953644](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads%2Fimage%2F2024-06-15%2F1719539cd888a.png)

## 二、设置密码鉴权

若选择密码鉴权方式，那么后续在使用代理IP请求时，都需要携带pwd参数。

如下图该链接缺少pwd参数，会提醒"Api授权不通过，请检查Api鉴权配置"。

![image-20240615173022792](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads%2Fimage%2F2024-06-15%2F1730220e7265b.png)

加上pwd参数之后，即可顺利执行请求。

![image-20240615172907689](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads%2Fimage%2F2024-06-15%2F172907d1065a1.png)

请记住，开启密码鉴权方式后，正确的请求地址是：https://share.proxy.qg.net/get?key=请改成您的key&pwd=请改成您的pwd。

## 三、设置白名单鉴权

若选择白名单鉴权方式，系统将会验证判断--请求IP是否在白名单范围内。

![image-20240615173356010](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads%2Fimage%2F2024-06-15%2F173356aa19e83.png)

意思是，您在哪个IP地址上进行API请求，就需要把对应IP地址输入到以上框中。这样便可顺利执行请求了。