获取迷你号好友列表

接口说明

用于按迷你号查询该账号的好友列表，供需要展示或统计迷你世界好友关系的调用方使用。请求成功时返回好友数量与好友列表数据。

调用地址

https://mini10.top/api/friend-list.php

请求方式

GET。调用时通过 URL 查询串传入参数 uin（迷你号），该参数为必填项。

鉴权说明

本接口无需鉴权，不需要传递任何密钥。

请求参数

调用地址：https://mini10.top/api/friend-list.php，请求方式：GET，无需密钥，免费调用。

参数取值说明：

• uin 需为有效的迷你号字符串，传入非迷你号内容将无法返回有效好友数据。
• 本接口无其他可选参数，除 uin 外的附加参数不参与处理。

成功响应示例

{
  "code": "0",
  "count": 0,
  "UinList": []
}

响应字段说明

错误响应示例

当请求未能正常完成时，接口返回 JSON 对象，字段 code 固定为 0，msg 为可读的错误说明，errcode 为业务错误码，便于定位具体原因。

未提供调用密钥时的响应示例：

{
  "code": 0,
  "msg": "未提供调用密钥",
  "errcode": 11001
}

密钥错误时的响应示例：

{
  "code": 0,
  "msg": "密钥错误",
  "errcode": 11002
}

积分余额不足时的响应示例：

{
  "code": 0,
  "msg": "积分余额不足",
  "errcode": 11004
}

接口不存在时的响应示例：

{
  "code": 0,
  "msg": "接口不存在",
  "errcode": 11013
}

请求方式不允许（例如对仅支持 GET 的地址发起其他方法）时的响应示例：

{
  "code": 0,
  "msg": "请求方式不允许",
  "errcode": 11018
}

接口维护中时的响应示例：

{
  "code": 0,
  "msg": "接口维护中",
  "errcode": 11006
}

本接口为免费接口、无需密钥，正常调用不会因密钥或积分原因失败；上述错误码表用于统一说明本站各接口可能返回的业务错误，便于调用方按 errcode 做统一处理。

业务错误码说明

响应体中的 errcode 为业务错误码，仅在请求未正常完成时出现。调用方可依据该值判断失败原因并决定是否重试或调整参数。完整错误码如下：

说明：

• 业务错误码按上述取值返回，未列出的 errcode 视为未知错误，可按 msg 内容辅助判断。
• 同一请求可能先后经过密钥校验、频率限制、积分结算与接口执行等多个环节，返回的错误码为实际触发的那一项。
• 对于 11005 一类的频率限制错误，建议降低调用频率后重试；对于 11006、11009、11010、11017 一类的临时性错误，建议稍后重试；对于 11001、11002、11003、11012、11023、11025 一类的鉴权类错误，需调整调用密钥或其传递方式后再试；对于 11013、11014、11015、11018 一类的请求类错误，需核对调用地址与请求方式。
• 获取迷你号好友列表为免费接口且无需密钥，调用时只需按文档给出的地址与请求方式提交参数即可。

调用示例

终端 curl（bash）

curl -G "https://mini10.top/api/friend-list.php" \
  --data-urlencode "uin=123456789"

PHP

// PHP 示例
$url = "https://mini10.top/api/friend-list.php?uin=" . urlencode("123456789");

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 10);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
if (isset($data['code'])) {
    echo "状态码：" . $data['code'] . PHP_EOL;
    echo "好友数量：" . $data['count'] . PHP_EOL;
}

注意事项

• 参数以字符串传递：uin（迷你号）为字符串类型，请求时请勿先转成整数再拼接，以免丢失前导零或产生精度误差；若号码中含特殊字符，需先做 URL 编码。
• 请求地址固定：请按 https://mini10.top/api/friend-list.php 原样调用，uin 作为查询参数附加在地址后；建议使用 HTTPS 访问，避免明文传输被篡改。
• 成功判定看 code：返回的 code 为字符串 "0"，请以字符串形式比较，不要与数字 0 混用；count 与 UinList 可能为空（count 为 0、列表为空数组），属正常结果，调用方需做好空值兜底，不要直接对列表做下标访问。
• 无需密钥但请控制频率：本接口免费且不校验密钥，请不要把调用地址当作可无限轮询的数据源，避免短时间内高频重复请求同一 uin；如需展示好友列表，建议在本地做适当缓存。
• 号码有效性：仅传入真实存在的迷你号；号码不存在或格式非法时，返回结果可能为空或与预期不一致，请以实际响应为准并提示用户核对输入。
• 不要在客户端硬编码业务数据：虽然本接口无需密钥，但仍不建议将返回的好友数据长期落库或对外二次分发，注意保护账号相关信息。