简介
欢迎使用青鸽 API 云开发者文档。我们提供了一套简单、强大且统一的 HTTP API 接口，帮助您快速将 IP 查询、短信发送、实名认证等能力集成到您的应用中。
开始之前，请确保您已注册青鸽 API 云账号并获取了 AppCode。 前往注册 >
接口基准地址
所有 API 请求均基于以下根 URL：
https://market.24cod.com/api/gateway请求方式
青鸽 API 云支持以下 HTTP 请求方法：
| 方法 | 描述 |
|---|---|
| GET | 用于获取资源（如查询 IP、获取天气）。 |
| POST | 用于创建资源或执行动作（如发送短信）。 |
鉴权认证
青鸽 API 云使用 AppCode 进行身份验证。在调用 API 时，需要在 HTTP 请求头中携带您的 AppCode。
Authorization: AppCode YOUR_APP_CODE错误码说明
| 错误码 | 说明 |
|---|---|
| 200 | 请求成功 |
| 400 | 请求参数错误 |
| 401 | AppCode 无效 |
| 402 | 余额不足 |
| 403 | 无权限访问 |
| 500 | 服务器内部错误 |
SDK 接入
推荐使用我们提供的官方 SDK，已封装了鉴权、重试等逻辑。
// 安装: composer require qingge/sdk
require "vendor/autoload.php";
use QingGe\Client;
$client = new Client("YOUR_APP_CODE");
// 调用示例
$result = $client->ip_query(["ip" => "8.8.8.8"]);
print_r($result);
