墨西哥实时数据综合 API 墨西哥实时数据综合 APIGET 查询 AFORE 账户

查询 AFORE 账户

GET/afore/account-20%0.4 USDT/次0.32 USDT/次

免费计费说明：发生异常时不收取费用。
空结果计费说明：该接口每天最多提供 10 次免费空结果查询。
空结果定义：服务器查询结果为空，未找到任何数据。

查询 AFORE，并返回所提供 CURP 对应的结构化退休金账户信息，包括 AFORE 机构、参保类型、登记状态、身份验证结果和数字档案等级。

以下为完整的合成示例数据。请使用您有权查询的数据进行在线测试；在线测试显示接口实际返回结果。

开始使用这个接口

  1. 注册账号，或使用已有账号。
  2. 在「账号 → 安全」中复制 API Token。
  3. 在「在线测试」中输入 Token 和您有权查询的原始数据。脱敏示例仅用于说明格式，实际调用时须替换。

在线测试受账号测试额度和网关规则约束。正式调用前，请确认接口单价和可用余额。 查看余额与充值

阅读快速接入指南

请求头参数

名称类型是否必填描述
X-Api-Tokenstring必填您的平台 API 令牌

参数

名称位置类型是否必填示例描述
curpquerystring必填TEST900101HDFABC0118-character CURP code

响应 200JSON

{
  "data": {
    "afore_code": "534",
    "afore_name": "SAMPLE USER",
    "affiliation_type": "REGISTRADO",
    "registration_status": "Auto-Vinculado",
    "identity_verified": true,
    "in_financial_bureau": true,
    "digital_profile_code": "2",
    "digital_maturity_level": "INTERMEDIO"
  },
  "status": 200,
  "message": "Found",
  "success": true
}

数据来源

记录持有方
CONSAR / AFORE — Sistema de Ahorro para el Retiro 官方站点
数据类别
退休储蓄账户
国家
墨西哥 · 公共机构

API Pull 不持有该记录的自有副本。每次调用都转发给上述来源，并把返回内容原样传回；准确性与可用性取决于该来源。

全部数据来源与留存说明 →

速率限制与免费额度

每秒请求数上限
10
每日免费空结果次数
10

未命中记录的调用在此额度内不计费。超出后，空结果按单价计费。

扣费发生在调用当时。余额不足时网关返回 402，且不会发起调用。

错误码

以下是生产环境实际观测到的状态码及其处理方式。未列出的状态码尚未出现过。

状态码含义与处理方式
200请求已到达上游并有响应返回。其中包含“查无记录”的情形，因此要看载荷内容，不能只看状态码。
402预付余额不足以支付本次调用。调用未发起，也未扣费。充值后重试。
504上游未在时限内响应。请稍后重试；对慢速登记机构而言这是正常的失败形态。
404路由不存在，或该接口已下线。
401API token 缺失或无效。

使用条件

本接口返回的是由国家登记机构或机构持有的、关于可识别个人的个人数据。你必须对查询的每一个标识符具备合法依据，不得遍历标识符区间，也不得将结果作为对他人作出不利决定的唯一依据。

合法依据（服务条款第 3 条）·完整使用条件