> ## Documentation Index
> Fetch the complete documentation index at: https://docs.velafi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 基础 URL

> VelaFi 生产环境和沙盒环境 REST API 基础 URL 参考。在发起任何请求之前，请将 HTTP 客户端指向正确的环境。

VelaFi 提供两个 REST API 环境——用于真实流量的**生产环境**和用于集成测试的**沙盒环境**。您发起的每个 API 调用都以其中一个基础 URL 作为前缀。开发期间请选择沙盒环境，以确保测试永远不会涉及真实资金或用户数据；准备上线时再切换到生产环境 URL。

> [!NOTE]
>
> 对两个环境的所有请求都需要携带 `X-BH-TOKEN` 请求头，其中包含通过 `GET /v2/token/generate` 获取的令牌。请妥善保管生产环境凭证，并在测试期间使用单独的沙盒环境凭证。

## 环境

| 名称 | 基础 URL | 类型 |
| - | - | - |
| VelaFi | `https://api.velafi.com` | REST API |
| VelaFi 沙盒环境 | `https://api-test.velafi.com` | REST API |

## 用法

在每个端点路径前加上与目标环境对应的基础 URL。例如，国家列表端点将变为：

> [tab] 生产环境
>
> ```
> GET https://api.velafi.com/v2/base/countrys
> ```

> [tab] 沙盒环境
>
> ```
> GET https://api-test.velafi.com/v2/base/countrys
> ```

> [!TIP]
>
> 将基础 URL 存储在环境变量（例如 `VELAFI_BASE_URL`）中，这样无需修改代码即可在生产环境和沙盒环境之间切换。


## Related topics

- [API 概览](https://docs.velafi.com/cn/api-reference/overview.md)
- [创建 API 密钥](https://docs.velafi.com/cn/docs/guides/creating-api-key.md)
- [简介](https://docs.velafi.com/cn/docs/introduction.md)
- [商户](https://docs.velafi.com/cn/docs/merchants.md)
- [创建商户](https://docs.velafi.com/cn/docs/guides/creating-merchant.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.