要用接口查余额、下单或提取住宅代理，先登录拿到访问令牌，再在后续请求里携带它。官方认证文档写明：对外 API 使用 JWT Bearer Token；先用用户名和密码调用登录接口，然后在需要认证的请求头中带上返回的 token。本页只讲登录、带令牌，以及文档已经写明的认证错误。API 能做什么，见住宅代理 API 对接，本页不复制 OpenAPI。
控制台买流量或静态 IP 的人，不一定非走登录接口。本页面向需要对接余额、交易记录、购买动态流量或购买静态 IP的集成。仅限授权目标。不支持中国大陆使用。
开始前备齐什么
| 准备项 | 从哪里来 |
|---|---|
| 控制台用户名和密码 | 你自己的登录凭据；示例只用 USER_EXAMPLE 与 PASS_EXAMPLE_NOT_REAL |
| API 基础地址 | 文档统一为 https://backend.ztproxy.net/api |
| 存放令牌的位置 | 服务端或密钥管理系统，不要写进前端代码或日志 |
官方文档示例里的用户名、密码和 JWT 片段都不是你的实账户。本页一律改用假占位符。不要把用户名和密码写成 用户名:密码@主机 这种容易被当成邮箱的形式。
登录之后怎样带令牌
登录成功时，文档示例的业务码为 code: 0。响应里的 data.token 用于后续请求；data.user 里可能出现用户 ID、用户名、余额和状态等字段，那些数字只是文档示意，不是活账户。需要认证的接口在请求头中携带：
Authorization: Bearer <token>
把 <token> 换成你刚拿到的值，请求头里不要再附一份密码。文档给出的一个后续示例是查询仪表盘概览。令牌过期或无效时，应重新登录，而不是改订单参数硬重试。
登录示例
export ZTPROXY_BASE="https://backend.ztproxy.net/api"
curl -X POST "$ZTPROXY_BASE/auth/login" \
-H "Content-Type: application/json" \
-d '{
"username": "USER_EXAMPLE",
"password": "PASS_EXAMPLE_NOT_REAL"
}'成功后把返回的 token 存成环境变量，例如 ZTPROXY_TOKEN=TOKEN_EXAMPLE_NOT_REAL，再在其他请求中使用 Authorization: Bearer $ZTPROXY_TOKEN。不要把真实令牌提交到工单、截图或客户端仓库。英文文档见 Authentication，字段与中文页一致，提示文案以对应语言文档为准。
| 做法 | 说明 |
|---|---|
令牌放在 Authorization: Bearer 请求头 | 这是文档要求的用法 |
| 令牌或密码写入前端、日志、截图或工单 | 不要这样做 |
| 收到 401 且提示令牌无效或过期 | 重新登录后再请求一次，不要无令牌循环重试 |
文档中的认证错误
只处理官方认证页已经列出的错误，不在这里补全整本错误码表。更宽的业务错误见错误处理，客户端 407 或超时见连接排查。
| HTTP | 文档提示 | 含义与处理 |
|---|---|---|
| 401 | 未提供认证令牌 | 请求没带 Authorization 头，补上 Bearer 令牌 |
| 401 | 无效的认证令牌 | 令牌无效或已过期，重新登录后再试一次 |
| 401 | 用户不存在 | 令牌对应的用户已不存在，停止使用该令牌 |
| 403 | 账号未激活，请先前往邮箱点击激活链接 | 账号存在但未激活，先完成邮箱激活 |
官方英文认证页对应说明分别是 Authentication token missing、Invalid authentication token、User not found，以及 Account not activated。不要把这些认证错误理解成代理目标站返回的 407。
合规与范围
凭证和 token 保存在服务端或密钥管理系统中，不要写入前端代码或日志。只用于授权目标。价格以控制台与价格方案为准（动态约 $0.40/GB，100 TB 整包约 $0.20/GB；静态共享约 $1.50、独享约 $5 /IP/月）。USDT/USDC 可用；Visa/Mastercard 申请中。不支持中国大陆使用。
FAQ
控制台下单也必须先调登录接口吗？
不一定。控制台本身会完成登录。本页针对需要调用官方 API 的集成。网页开通与接口下单可以走同一条处理链路，但买家在控制台操作时，不必再单独传 token。
Token 应该放在请求头还是 URL？
放在 Authorization: Bearer 请求头。不要把令牌拼进查询字符串，也不要写进前端。
登录失败是不是也返回 401 邮箱或密码错误？
认证页列出的是令牌缺失、令牌无效、用户不存在和账号未激活。错误处理文档另外提到登录失败可能返回「邮箱或密码错误」。先核对用户名和密码，不要把它当成令牌过期。
401 之后能不能原样重试同一请求？
令牌缺失或无效时，应先补上或重新登录，再重试一次。用户已不存在时，换令牌也不会成功。不要在没有新令牌的情况下循环重试。
403 账号未激活怎么办？
按文档去邮箱点击激活链接。激活完成后再登录。这不是权限不足去管理下级用户。
这是不是 IP 免密认证？
不是。本页是账户登录后的 Bearer Token。代理连接仍要使用提取或订单返回的主机、端口、用户名和密码，分字段填写，见提取凭据。
返回里的余额能当对账结果吗？
登录响应里如果带余额，只是登录当时的示意字段。对账仍以余额接口和交易记录为准。
可以把 token 发给终端用户吗？
文档明确不要把账号、密码和 token 暴露给终端用户，也不要写入前端或日志。放在你的后端或密钥系统里。