Skip to main content
在本快速入门中，您将调用 Balance API 以确认基础 URL 和 API 密钥配置正确。

​
准备工作

您需要准备：
  • 一个 YCloud 账户
  • 一个 YCloud API 密钥
  • curl 或其他 HTTP 客户端

​
工作原理

每个服务端 API 请求都使用 https://api.ycloud.com/v2 基础 URL，并在 X-API-Key 请求头中发送您的密钥。本示例获取账户余额，因为它不会创建或发送任何内容。

​
请求

1

存储您的 API 密钥

在当前终端会话中导出密钥。请将占位符替换为您的真实密钥。
切勿将 API 密钥提交到源代码管理中。有关生产环境建议，请参阅身份验证。
2

查询余额

获取您的账户余额。

​
响应

成功的请求将返回 HTTP 200 及您的当前余额。
如果 API 返回 401 或 403，请检查请求头名称和 API 密钥。在添加重试机制前，请参阅处理错误。
成功的余额响应表明您的基础 URL 和 API 密钥配合正常。

​
后续步骤

发送 WhatsApp 消息

发送模板、文本和媒体消息。

配置 Webhook

接收送达状态更新和入站消息。

处理 API 错误

读取错误响应并设计安全的重试机制。

Balance API 参考

查看完整的响应模式并测试该端点。