# SPACE ID 解析不到名称：区分 HTTP、业务码与逐链错误

整理：链小知（AI 辅助）
资料核对日期：2026-10-12
引用地址：https://lianxiaozhi.com/tools/guides/space-id-api-empty-result-chain-errors
难度：进阶
核验方式：官方文档整理，未执行真实账户操作

用现有解析响应定位空地址、错误链参数和批量局部失败，避免 HTTP 200 或顶层 code=0 被误判为全部成功。

## 使用工具
- [SPACE ID](https://lianxiaozhi.com/tools/space-id) · [官方入口](https://space.id/)

## 前置条件
- 准备完整名称、目标网络及已有脱敏请求/响应；只有官方样本时，可按样本整理检查表，但不能当实时链上结果。
- 本教程针对名称 API；Payment ID 端点和编号另算，不需要注册或连接钱包。

## 1. 按问题选择方向和端点

名称找地址用 GET https://nameapi.space.id/getAddress?domain=<完整名称>；地址找主名称用 /getName?chainid=<编号>&address=<公开地址>。先在现有请求中确认方向、完整后缀及参数编码，再读取对应响应，别把逆查空名称解释成正向收款地址必然不存在。

核对结果：已标记正向或逆向，且保留原始请求 URL 与响应。
依据：[SPACE ID：名称 API、业务错误和链参数](https://docs.space.id/developer-guide/web3-name-api-and-sdk/web3-name-api)

## 2. 分开传输成功与业务结果

先记录 HTTP 状态及是否取得 JSON，再检查业务 code：0、1、-1 分别对应找到、未找到、错误。没有有效响应或业务错误时单列原因；缺少 address 不填零地址，也不从 HTTP 200 直接得出可收款。

核对结果：传输失败、无记录、业务错误和有效结果是四种状态。
依据：[SPACE ID：名称 API、业务错误和链参数](https://docs.space.id/developer-guide/web3-name-api-and-sdk/web3-name-api)

## 3. 读取逆查的实际数据层级

getName 官方 JSON 样本将名称放在 data.name，并带 data.chainID/errMsg。对照手中响应原结构取值，不能仅按字段说明假定 name 总在顶层；遇到层级不同，保存原字段并检查实际接口版本，不盲目改成空字符串。

核对结果：解析路径与原 JSON 一致，没有把缺字段判作无主名称。
依据：[SPACE ID：名称 API、业务错误和链参数](https://docs.space.id/developer-guide/web3-name-api-and-sdk/web3-name-api)

## 4. 核对编号体系和后缀用途

确认 .bnb 为 56、.arb 为 42161。该 API 附录的 .sol=900、.lens=903、.crypto=904 是接口定义，不拿 Polygon 的 137 替换它们；Payment ID 的 0–5 chainId 又是另一套。若名称为 .four，先识别其代币 CA 用途，不将返回值按个人收款地址处理。

核对结果：编号有产品出处；代币合约解析与钱包收款已分开。
依据：[SPACE ID：名称 API、业务错误和链参数](https://docs.space.id/developer-guide/web3-name-api-and-sdk/web3-name-api)
依据：[SPACE ID：解析 SDK 与 Payment ID 编号](https://docs.space.id/developer-guide/web3-name-api-and-sdk/web3-name-sdk.md)

## 5. 拆开批量查询的每一个结果

对已有 /getDomainNamesByChainIdList?chainlist=...&address=... 响应逐项保存请求编号、返回 chainID、name 与 errMsg。顶层 code=0 的官方样本同时含不支持链、找不到名称；有错误项的 chainID 可为 0，不能用它覆盖原请求编号或按空名称直接计为正常未设置。

核对结果：各链分别判成功/无记录/不支持或错误，保留请求与返回的对应证据。
依据：[SPACE ID：名称 API、业务错误和链参数](https://docs.space.id/developer-guide/web3-name-api-and-sdk/web3-name-api)

## 6. 形成修复条件再交回调用方

输出端点、方向、参数体系、原响应层级、业务码和逐项失败原因。如果调用方改用 core，另对照项目锁定版本和 RPC 超时；getAddress/getDomainName 的函数返回不是 HTTP API JSON，不能复用同一个响应解析器。

核对结果：修复建议能明确指出参数、数据层或错误分类，不声称已修复或实际到账。
依据：[SPACE ID：解析 SDK 与 Payment ID 编号](https://docs.space.id/developer-guide/web3-name-api-and-sdk/web3-name-sdk.md)
依据：[SPACE ID core 0.4.2：固定包依赖](https://raw.githubusercontent.com/Space-ID/web3-name-sdk/45172ee9d24a618e2533c50bb0d02061556f7c64/packages/core/package.json)

## 常见错误
- 官方页面示例并非本次实测响应，不能用其样本地址推断当前用户状态。
- API 能解析某后缀不证明目标钱包支持同一名称或支付网络。

## 完成检查
- 完成可复查的请求/响应分类表；空记录与错误分别保留。
- 费用、实际时效与未知接口版本独立标注；不把文档核验标为 API 实测。

## 相关知识
- [ENS 名称、注册人与解析地址有什么区别？](https://lianxiaozhi.com/learn/ens-name-and-resolver)
- [如何核对 Meme 币？先确认链、合约地址和交易池](https://lianxiaozhi.com/learn/meme-token-identity)

## 官方依据
- [SPACE ID：名称 API、业务错误和链参数](https://docs.space.id/developer-guide/web3-name-api-and-sdk/web3-name-api)
- [SPACE ID：解析 SDK 与 Payment ID 编号](https://docs.space.id/developer-guide/web3-name-api-and-sdk/web3-name-sdk.md)
- [SPACE ID core 0.4.2：固定包依赖](https://raw.githubusercontent.com/Space-ID/web3-name-sdk/45172ee9d24a618e2533c50bb0d02061556f7c64/packages/core/package.json)