身份验证

概览

在访问任何 Curosa API 端点之前，您需要进行身份验证并获取 API 令牌。此令牌将用于所有后续 API 请求的 Authorization 请求头中。

获取 API 令牌

要获取您的 API 令牌，请使用您的 Curosa 供应商门户凭据向登录端点发送 POST 请求。

请求

使用您现有的供应商门户电子邮件和密码进行身份验证：

curl --location 'https://api.curosa.com/v1/login' \
--form 'email="your@email.address"' \
--form 'password="your_supplier_portal_password"'

参数：

• email (必填)：您注册的电子邮件地址
• password (必填)：您的供应商门户密码

响应

身份验证成功后，您 beach 收到包含 API 令牌的响应：

{
    "message": "Authenticated",
    "status": "success",
    "data": {
        "token": "5|VivSxZyTcpL1xJrViiuPbiOoUoj8djslmaI4FeB89e4ba1c"
    }
}

重要提示： 请妥善保管此令牌。您需要将其作为 Bearer 令牌包含在所有 API 请求的 Authorization 请求头中：

示例响应

Authorization: Bearer 5|VivSxZyTcpL1xJrViiuPbiOoUoj8djslmaI4FeB89e4ba1c

令牌安全

• 确保您的 API 令牌安全，切勿公开分享
• 像对待密码一样对待您的令牌
• 如果您认为您的令牌已泄露，请求新令牌将自动使您账户下的任何其他令牌失效

速率限制

为了保护系统免受暴力破解攻击，该端点的速率限制为每小时 10 次请求。