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

# 验证

我们使用 OAuth 2.0 进行 API 身份验证。请遵循我们的最佳实践，了解如何安全地生成和使用访问令牌。

请确保在您发送的每个请求中，都通过 `Authorization` 请求头包含 `Bearer` 方案和您的访问令牌。

## 生成访问令牌

在发出 API 请求之前，您需要通过向[生成访问令牌](https://docs.localpayment.com/zh/reference/get-token.md)endpoint 发送请求来获取访问令牌。

### 请求示例

```bash curl theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
curl --request POST \
     --url https://api.stage.localpayment.com/api/token/ \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "username": "user@example.com",
  "password": "<PASSWORD>"
}
'
```

### 响应示例

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "refresh": "eyJ0eXAiOiJKV1QiLCJhbGccM5kYO7o4iOiJIU18jaiJ9.eyJ0b2tlbl90eXBlIjoicmVmcmVzaCIsImV4cCI6MTczNTMxOTkyOSwianRpIjoiZWUxMDE3MTUwY2JhNGM1NTg0MjYyZmRkZTdiOThiNGQiLCJ1c2VyX2lkIjoxMDAwLCJzdXBlcnVzZXIiOnRydWUsImlzX3N0YWZmIjp0cnVlLCJybaCIsImV4cCI62xlcyI6WyJBTEwiXSwiY291bnRyaWVzIjpbIkFMTCJdLCJjb21wYW55IjoiQUxMIiwiY2xpZW50X2NvZGUiOiJBNzaW9uTEwiLCJwZXJtaXcyI6W119.6siymomkQ72yMvHGU9sMCO4h-cxpNgQXor",
  "access": "eyJ0eXAiOiJKV1QiLCJhJIUzI1NiJ9.eyJ0b2tlbl90eXBlIbGciOijoiYWNjZXNzIiwiZXhwIjoxNzM1MjMzODI5LCJqdGkiOiJiMDRmNzQ3YWEjOCIsIn4Mjg0YjM0YmMwN2Y4ZjVkOWM0NWFVzZXJfaWQiOjEwMDAsInN1cGVydXNlciI6dHJ1ZSwiaXNfc3RhZmYiOnRy3VudHJpZXMiOljpbIkFsiQUxMIl0sImNvbXBhbnkiOiJBTEwiLCJjbGllbnRfY29kZSI6IkFMTCIsInBlcm1pc3Npb25zIjpdWUsInJvbGVzIMTCJdLlqEnH7GrECJjbbXX0.sWOLKFxCcXQkUcPvTjYceXBp39hDF3-Snc"
}
```

***

## 使用访问令牌

收到 `access` 令牌后，请在所有后续 API 请求中，将其作为 Bearer 令牌包含在 `Authorization` 请求头中。

### 请求示例

```bash curl theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
curl --request POST \
     --url https://api.stage.localpayment.com/api/validation/document \
     --header 'Authorization: Bearer <your_access_token>' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "country": "ARG",
  "document": {
    "id": "1791234561009",
    "type": "RUC"
  }
}
'
```

查看有关[身份验证](https://docs.localpayment.com/zh/reference/authentication-overview.md)的详细信息。

### 使用凭证的最佳实践

您的 API 凭证对 Localpayment 集成至关重要。请遵循以下最佳实践来确保其安全：

* 使用环境变量或密钥管理器安全地存储凭据——切勿将其硬编码或提交到版本控制系统中。
* 限制访问权限，仅限授权团队成员；并撤销任何您怀疑已被泄露的凭证。
* 沙盒环境和生产环境使用不同的凭据。
* 定期监控API日志，以检测异常活动。
* 绝不要在客户端代码、移动应用或公共代码库中暴露凭据。


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