API.CC API 文档：接码链接、接码记录和开发者接入说明

API.CC API 文档打不开时应该看哪里？

如果后台 API 文档链接因为登录状态、Cloudflare 验证或浏览器环境打不开，可以先看本页。开发者接入前最重要的不是直接复制接口，而是先用 1 个号码人工跑通购买、触发验证码、查看接码记录和确认号码有效期。需要正式接入时，再登录 API.CC 后台，在 API 管理、订单 API 和接码记录里查看自己的接码链接、token 和接口参数。

操作步骤

1. 先登录 API.CC 后台，购买 1 个需要的国家和项目号码。
2. 在订单管理里查看手机号码和接码地址，先人工确认验证码能到达。
3. 在接码记录里查看来码时间、短信内容和验证码显示是否正常。
4. 在 API 管理里查看号码状态、到期时间、续费、导出、过户和更换 token。
5. 开发接入时隐藏 token，不要把接码链接、token、真实号码和订单截图发到公开页面。
6. 系统侧增加超时、重试、失败原因记录和到期提醒，稳定后再批量购买。

为什么不再直接跳到后台 API 文档链接

后台 API 文档属于登录后页面，部分网络环境会遇到 Cloudflare 验证、登录状态失效或浏览器限制。直接把公开站点按钮指向登录后地址，会导致用户点击后看到空白、403 或无法打开。

因此公开站点统一改为站内 API 文档说明页。用户先在这里理解 API.CC 的接码逻辑、人工测试流程和安全边界，再从登录入口进入后台查看自己的真实接口参数。

API 接入前必须先人工测试

第一次接入不要直接批量购买，也不要直接写代码。先买 1 个号码，确认目标平台会发送短信、验证码能到达、接码记录能显示、号码有效期符合需求。

人工测试通过后，再把成功的国家、项目、号码类型、到达时间和失败原因整理出来。这样后续写 API 自动化时，问题会更容易定位。

接码链接和 token 的含义

购买号码后，订单里会看到手机号码和接码地址。接码地址通常包含用于读取短信的凭证信息，token 用于控制接码链接权限。

如果接码链接分享给别人后不想继续让对方查看验证码，可以在 API 管理里更换 token。更换后，旧链接会失效，新链接继续用于查看验证码。公开教程和视频必须遮挡 token、真实号码和订单信息。

开发者应该处理哪些异常

API 自动化读取验证码时，应处理短信未到达、目标平台未发送短信、号码到期、token 失效、重复请求、接口超时、短信延迟和项目选错等情况。

建议系统记录订单、项目、号码类型、请求时间、收到时间、失败原因和重试次数。不要只写一个无限刷新逻辑，否则遇到目标平台不发短信时会浪费余额和排查时间。

什么时候去后台看正式 API 文档

当你已经完成 1 个号码的人工测试，并且确认确实需要批量读取验证码、自动保存记录或接入自己的业务系统时，再登录 API.CC 后台查看 API 文档和 API 管理。

如果只是新用户学习购买和收码流程，优先看图文教程、平台说明和接码记录说明，不需要一开始就研究接口。

实际操作时怎么判断

如果你是第一次使用 API.CC，建议把问题拆成三步：先确认你需要的国家和项目，再确认号码有效期、卡类型和价格，最后用 1 个号码完成完整流程测试。测试内容包括：能否复制接码地址、目标平台是否发送短信、接码记录是否出现验证码、后续再次验证是否还能继续使用同一个号码。

批量购买前不要只看单价，还要看有效期、续费规则、是否支持你需要的项目、是否需要指定号段或排除号段。对稳定性要求高的业务，应先小批量验证，记录可用项目、可用号段和失败原因，再扩大购买数量。

API.CC 的核心区别是按号码出售。只要号码没有到期，号码和对应项目就属于购买用户，用户可以循环接收验证码，并在 API 管理里查看号码状态、到期时间、接码链接、续费、导出和 token。这个逻辑和传统一次性接码不同，因此购买前要重点理解“有效期内独占”和“循环接码”。

购买后出现问题怎么处理

收不到验证码时，先刷新接码记录并确认目标平台已经触发短信；如果号码到期，需要在 API 管理查看是否支持续费；如果接码链接分享给别人后需要收回权限，可以更换 token。对于找不到项目、充值未到账、订单异常或需要添加项目的情况，可以联系 Telegram 客服 https://t.me/api52 或站内客服系统。

如果你购买的是长期号码，重点检查即将到期 API 和续费规则；如果你使用的是免费接码，注意公开号码可能被多人测试，不适合需要隐私或长期后续验证的业务；如果你使用的是美国实卡一次性接码，超时和退款规则按该入口说明处理。

合规说明

本页用于帮助用户理解 API.CC 后台功能和号码选择逻辑，适合合规的产品测试、开发调试、短信到达率验证和业务流程验证。请勿用于欺诈、垃圾注册、绕过平台规则、金融违规或其他违法用途。