npm Public Registry API：包元数据与版本查询

npm 官方仓库文档列出包元数据、指定版本与搜索接口的 GET 相对路径及 JSON 字段。本附件没有单独确证 API base URL、认证、费用或限流；仅文档整理，未实测。

Source statements below remain in their published language. Collection, contributor reports and a provider's identity are separate; this page does not certify quality, current availability or permission to execute.

Stable ID: cap-0806525017377ae56c25dfbc
Card version: 2
Updated: 2026-10-24T17:08:32.7505650+00:00
Ownership state: unclaimed
Processing: unknown
Evidence level: unknown
Business execution: unknown

Keep this fixed version · Original public source · Complete machine record

Published description

本卡聚焦 Public Registry API 的 GET /{package} 与 GET /{package}/{version}。文档将包元数据称为 packument，描述 dist-tags、versions、依赖和分发链接，并另列搜索参数及示例。分发 tarball 的 URL 模板不直接替代 API base URL 声明。

Inputs

package：包名；/{package}/{version} 的 version 可为版本号或 latest。
搜索另用 /-/v1/search，text 为全文查询，size 默认20、最大250，from 为偏移量；质量、流行度和维护度权重另有参数。

Outputs

包元数据文档 packument：字段含 name、description、dist-tags、versions、time、author、repository、readme。
版本信息含 name、version、dependencies、devDependencies、scripts、license 及 dist 中的 shasum、tarball 链接等。
搜索示例含 objects、total、time 及评分字段；文档中的样例时间、版本和统计不是当前查询结果。

Invocation and authentication

unknown

{
  "authentication": {
    "kind": "unknown",
    "notes": "\u672C\u9644\u4EF6\u672A\u660E\u786E\u516C\u5F00\u5143\u6570\u636E GET \u7684\u8BA4\u8BC1\u8981\u6C42\uFF0C\u6807\u9898 Public \u4E0D\u7B49\u4E8E\u5B8C\u6574\u7684\u8BA4\u8BC1\u4FDD\u8BC1\u3002"
  },
  "command": null,
  "entry_url": null,
  "kind": "http_api",
  "method": "GET",
  "request_example": {
    "method": "GET",
    "notes": "\u76F8\u5BF9\u8DEF\u5F84\u793A\u4F8B\uFF0C\u5C1A\u7F3A\u672C\u9644\u4EF6\u72EC\u7ACB\u786E\u8BC1\u7684 API base URL\uFF1B\u672A\u6267\u884C\u3002",
    "path": "/{package}",
    "path_parameters": {
      "package": "yargs"
    }
  },
  "requirements": [
    "\u4F9D\u636E\u9644\u4EF6\u76F8\u5BF9\u8DEF\u5F84\u67E5\u8BE2 package\uFF0C\u6216 package \u4E0E version\uFF1B\u5B8C\u6574 API base URL \u5F85\u660E\u786E\u8BC1\u636E\u8865\u5145\u3002",
    "\u672C\u9644\u4EF6\u51FA\u73B0 registry.npmjs.org \u7684 tarball URL \u6A21\u677F\uFF0C\u4F46\u4E0D\u5C06\u5206\u53D1\u6A21\u677F\u81EA\u52A8\u89C6\u4F5C\u5168\u90E8 API \u7684 host \u5951\u7EA6\u3002",
    "\u53EA\u6574\u7406\u6587\u6863\uFF0C\u4E0D\u4F7F\u7528 npm\u3001\u4E0B\u8F7D tarball\u3001\u6267\u884C scripts \u6216\u8C03\u7528 registry\u3002"
  ]
}

Commands and request examples are documentation only; this page does not execute them. Confirm external installation, disclosure and fees separately.

Third-party pricing and data handling

{
  "model": "unknown",
  "notes": "\u552F\u4E00\u9644\u4EF6\u672A\u58F0\u660E API \u6536\u8D39\u6216\u514D\u8D39\u989D\u5EA6\u3002",
  "source_url": "https://github.com/npm/registry/blob/main/docs/REGISTRY-API.md"
}

{
  "location": "provider_server",
  "notes": "\u6587\u6863\u63CF\u8FF0\u516C\u5171 registry \u7684\u8FDC\u7A0B\u5305\u67E5\u8BE2\uFF0C\u672A\u7ED9\u67E5\u8BE2\u65E5\u5FD7\u4E0E\u4FDD\u7559\u653F\u7B56\u3002\u672C\u6B21\u672A\u53D1\u9001\u5305\u540D\u3001\u51ED\u636E\u3001\u6587\u4EF6\u6216\u6267\u884C\u5305\u5185\u5BB9\u3002"
}

Unknown is not a claim that a service is free, anonymous, private or unavailable.

Limitations

本文只列相对 API 路径；本卡未补造完整 GET 调用地址。
latest 是允许的版本参数或 dist-tag，不在本卡推断其必然代表最新正式版本。
scripts 和 tarball 是元数据字段，不代表应执行脚本或下载包。
本页没有明确认证、API 费用、调用配额、限流、数据新鲜度或 SLA；旧示例不可视为现行实际响应。

Unknowns

本附件独立确证的 API base URL、认证、费用、限流、配额和 SLA 未知。
当前包的实际版本、响应格式兼容性及数据完整性未实测。

Fixed profiles, conditions and evidence

Read state: not_checked; review state: unknown. Do not combine different profiles.

资料与来源声明不等于本站实测；未列出的条件仍未知。

结构化配方只按公开声明检查约束与接口，不执行任务或授予权限；缺失记录保持未知，接口兼容不证明实际成功。

Contributor-reported verification

{
  "checked_at": "2026-10-24T17:06:15.4527040\u002B00:00",
  "checks_performed": [
    "\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
  ],
  "evidence_urls": [
    "https://github.com/npm/registry/blob/main/docs/REGISTRY-API.md"
  ],
  "level": "documentation_only",
  "not_verified": [
    "\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
  ],
  "outcome": "not_tested",
  "reported_by": "contributor",
  "software_version": null,
  "test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
}

Connection, installation, execution, output checks and user acceptance are different stages. This is not a commercial call or income receipt.

Dynamic observations and corrections

null

null

Add a public correction or observation

Submit only facts you may disclose, without private tasks, customer data or credentials. Corrections are proposals; observations are conditional contributor reports, not automatically verified facts, commercial calls or income.

Propose a sourced summary correction

Report a conditional public observation

Complete fixed public record and original source fields

This is the existing public read projection, not a translated or rewritten snapshot. Dynamic observations, where present, remain labelled separately from evidence.

{
  "author_name": "npm",
  "availability": "unknown",
  "callability": "documentation_only",
  "category": "development",
  "data_handling": {
    "location": "provider_server",
    "notes": "\u6587\u6863\u63CF\u8FF0\u516C\u5171 registry \u7684\u8FDC\u7A0B\u5305\u67E5\u8BE2\uFF0C\u672A\u7ED9\u67E5\u8BE2\u65E5\u5FD7\u4E0E\u4FDD\u7559\u653F\u7B56\u3002\u672C\u6B21\u672A\u53D1\u9001\u5305\u540D\u3001\u51ED\u636E\u3001\u6587\u4EF6\u6216\u6267\u884C\u5305\u5185\u5BB9\u3002"
  },
  "description": "\u672C\u5361\u805A\u7126 Public Registry API \u7684 GET /{package} \u4E0E GET /{package}/{version}\u3002\u6587\u6863\u5C06\u5305\u5143\u6570\u636E\u79F0\u4E3A packument\uFF0C\u63CF\u8FF0 dist-tags\u3001versions\u3001\u4F9D\u8D56\u548C\u5206\u53D1\u94FE\u63A5\uFF0C\u5E76\u53E6\u5217\u641C\u7D22\u53C2\u6570\u53CA\u793A\u4F8B\u3002\u5206\u53D1 tarball \u7684 URL \u6A21\u677F\u4E0D\u76F4\u63A5\u66FF\u4EE3 API base URL \u58F0\u660E\u3002",
  "inputs": [
    "package\uFF1A\u5305\u540D\uFF1B/{package}/{version} \u7684 version \u53EF\u4E3A\u7248\u672C\u53F7\u6216 latest\u3002",
    "\u641C\u7D22\u53E6\u7528 /-/v1/search\uFF0Ctext \u4E3A\u5168\u6587\u67E5\u8BE2\uFF0Csize \u9ED8\u8BA420\u3001\u6700\u5927250\uFF0Cfrom \u4E3A\u504F\u79FB\u91CF\uFF1B\u8D28\u91CF\u3001\u6D41\u884C\u5EA6\u548C\u7EF4\u62A4\u5EA6\u6743\u91CD\u53E6\u6709\u53C2\u6570\u3002"
  ],
  "invocation": {
    "authentication": {
      "kind": "unknown",
      "notes": "\u672C\u9644\u4EF6\u672A\u660E\u786E\u516C\u5F00\u5143\u6570\u636E GET \u7684\u8BA4\u8BC1\u8981\u6C42\uFF0C\u6807\u9898 Public \u4E0D\u7B49\u4E8E\u5B8C\u6574\u7684\u8BA4\u8BC1\u4FDD\u8BC1\u3002"
    },
    "command": null,
    "entry_url": null,
    "kind": "http_api",
    "method": "GET",
    "request_example": {
      "method": "GET",
      "notes": "\u76F8\u5BF9\u8DEF\u5F84\u793A\u4F8B\uFF0C\u5C1A\u7F3A\u672C\u9644\u4EF6\u72EC\u7ACB\u786E\u8BC1\u7684 API base URL\uFF1B\u672A\u6267\u884C\u3002",
      "path": "/{package}",
      "path_parameters": {
        "package": "yargs"
      }
    },
    "requirements": [
      "\u4F9D\u636E\u9644\u4EF6\u76F8\u5BF9\u8DEF\u5F84\u67E5\u8BE2 package\uFF0C\u6216 package \u4E0E version\uFF1B\u5B8C\u6574 API base URL \u5F85\u660E\u786E\u8BC1\u636E\u8865\u5145\u3002",
      "\u672C\u9644\u4EF6\u51FA\u73B0 registry.npmjs.org \u7684 tarball URL \u6A21\u677F\uFF0C\u4F46\u4E0D\u5C06\u5206\u53D1\u6A21\u677F\u81EA\u52A8\u89C6\u4F5C\u5168\u90E8 API \u7684 host \u5951\u7EA6\u3002",
      "\u53EA\u6574\u7406\u6587\u6863\uFF0C\u4E0D\u4F7F\u7528 npm\u3001\u4E0B\u8F7D tarball\u3001\u6267\u884C scripts \u6216\u8C03\u7528 registry\u3002"
    ]
  },
  "limitations": [
    "\u672C\u6587\u53EA\u5217\u76F8\u5BF9 API \u8DEF\u5F84\uFF1B\u672C\u5361\u672A\u8865\u9020\u5B8C\u6574 GET \u8C03\u7528\u5730\u5740\u3002",
    "latest \u662F\u5141\u8BB8\u7684\u7248\u672C\u53C2\u6570\u6216 dist-tag\uFF0C\u4E0D\u5728\u672C\u5361\u63A8\u65AD\u5176\u5FC5\u7136\u4EE3\u8868\u6700\u65B0\u6B63\u5F0F\u7248\u672C\u3002",
    "scripts \u548C tarball \u662F\u5143\u6570\u636E\u5B57\u6BB5\uFF0C\u4E0D\u4EE3\u8868\u5E94\u6267\u884C\u811A\u672C\u6216\u4E0B\u8F7D\u5305\u3002",
    "\u672C\u9875\u6CA1\u6709\u660E\u786E\u8BA4\u8BC1\u3001API \u8D39\u7528\u3001\u8C03\u7528\u914D\u989D\u3001\u9650\u6D41\u3001\u6570\u636E\u65B0\u9C9C\u5EA6\u6216 SLA\uFF1B\u65E7\u793A\u4F8B\u4E0D\u53EF\u89C6\u4E3A\u73B0\u884C\u5B9E\u9645\u54CD\u5E94\u3002"
  ],
  "outputs": [
    "\u5305\u5143\u6570\u636E\u6587\u6863 packument\uFF1A\u5B57\u6BB5\u542B name\u3001description\u3001dist-tags\u3001versions\u3001time\u3001author\u3001repository\u3001readme\u3002",
    "\u7248\u672C\u4FE1\u606F\u542B name\u3001version\u3001dependencies\u3001devDependencies\u3001scripts\u3001license \u53CA dist \u4E2D\u7684 shasum\u3001tarball \u94FE\u63A5\u7B49\u3002",
    "\u641C\u7D22\u793A\u4F8B\u542B objects\u3001total\u3001time \u53CA\u8BC4\u5206\u5B57\u6BB5\uFF1B\u6587\u6863\u4E2D\u7684\u6837\u4F8B\u65F6\u95F4\u3001\u7248\u672C\u548C\u7EDF\u8BA1\u4E0D\u662F\u5F53\u524D\u67E5\u8BE2\u7ED3\u679C\u3002"
  ],
  "pricing": {
    "model": "unknown",
    "notes": "\u552F\u4E00\u9644\u4EF6\u672A\u58F0\u660E API \u6536\u8D39\u6216\u514D\u8D39\u989D\u5EA6\u3002",
    "source_url": "https://github.com/npm/registry/blob/main/docs/REGISTRY-API.md"
  },
  "provider_claimed": false,
  "record_kind": "public_source",
  "representative_queries": [],
  "sources": [
    {
      "basis": "official_documentation",
      "checked_at": "2026-10-25T01:06:15.452704\u002B08:00",
      "title": "registry/docs/REGISTRY-API.md at main \u00B7 npm/registry \u00B7 GitHub",
      "url": "https://github.com/npm/registry/blob/main/docs/REGISTRY-API.md"
    }
  ],
  "summary": "npm \u5B98\u65B9\u4ED3\u5E93\u6587\u6863\u5217\u51FA\u5305\u5143\u6570\u636E\u3001\u6307\u5B9A\u7248\u672C\u4E0E\u641C\u7D22\u63A5\u53E3\u7684 GET \u76F8\u5BF9\u8DEF\u5F84\u53CA JSON \u5B57\u6BB5\u3002\u672C\u9644\u4EF6\u6CA1\u6709\u5355\u72EC\u786E\u8BC1 API base URL\u3001\u8BA4\u8BC1\u3001\u8D39\u7528\u6216\u9650\u6D41\uFF1B\u4EC5\u6587\u6863\u6574\u7406\uFF0C\u672A\u5B9E\u6D4B\u3002",
  "tags": [
    "http_api",
    "documentation_only",
    "package_metadata"
  ],
  "terms_url": null,
  "title": "npm Public Registry API\uFF1A\u5305\u5143\u6570\u636E\u4E0E\u7248\u672C\u67E5\u8BE2",
  "unknowns": [
    "\u672C\u9644\u4EF6\u72EC\u7ACB\u786E\u8BC1\u7684 API base URL\u3001\u8BA4\u8BC1\u3001\u8D39\u7528\u3001\u9650\u6D41\u3001\u914D\u989D\u548C SLA \u672A\u77E5\u3002",
    "\u5F53\u524D\u5305\u7684\u5B9E\u9645\u7248\u672C\u3001\u54CD\u5E94\u683C\u5F0F\u517C\u5BB9\u6027\u53CA\u6570\u636E\u5B8C\u6574\u6027\u672A\u5B9E\u6D4B\u3002"
  ],
  "verification": {
    "checked_at": "2026-10-24T17:06:15.4527040\u002B00:00",
    "checks_performed": [
      "\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
    ],
    "evidence_urls": [
      "https://github.com/npm/registry/blob/main/docs/REGISTRY-API.md"
    ],
    "level": "documentation_only",
    "not_verified": [
      "\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
    ],
    "outcome": "not_tested",
    "reported_by": "contributor",
    "software_version": null,
    "test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
  },
  "schema_version": "navonavo.capability.v1",
  "service_id": "cap-0806525017377ae56c25dfbc",
  "version": 2,
  "source_url": "https://github.com/npm/registry/blob/main/docs/REGISTRY-API.md",
  "ownership_state": "unclaimed",
  "submitted_by": {
    "kind": "importer",
    "name": "NAVONAVO public material importer"
  },
  "submitter_identity_verified": false,
  "source_check": {
    "url": "https://github.com/npm/registry/blob/main/docs/REGISTRY-API.md",
    "final_url": "https://github.com/npm/registry/blob/main/docs/REGISTRY-API.md",
    "status_code": 200,
    "title": "registry/docs/REGISTRY-API.md at main \u00B7 npm/registry \u00B7 GitHub",
    "description": "npm registry documentation. Contribute to npm/registry development by creating an account on GitHub.",
    "checked_at": "2026-10-24T17:06:15.452704\u002B00:00",
    "warnings": [
      "\u6765\u6E90\u53EF\u8BFB\u53D6\u53EA\u8BC1\u660E\u672C\u6B21\u8D44\u6599\u8BFB\u53D6\uFF0C\u4E0D\u662F\u529F\u80FD\u3001\u8EAB\u4EFD\u6216\u957F\u671F\u53EF\u7528\u6027\u8BA4\u8BC1\u3002"
    ]
  },
  "created_at": "2026-10-24T17:06:18.5822642\u002B00:00",
  "updated_at": "2026-10-24T17:08:32.7505650\u002B00:00",
  "read_url": "https://navonavo.com/api/v1/capabilities/cap-0806525017377ae56c25dfbc?version=2",
  "page_url": "https://navonavo.com/capabilities/cap-0806525017377ae56c25dfbc?version=2",
  "verification_scope": "verification\u4E3A\u6295\u7A3F\u8005\u4E0A\u62A5\uFF1Bsource_check\u4EC5\u4E3A\u672C\u7AD9\u6765\u6E90\u8BFB\u53D6\uFF0C\u4E0D\u5347\u7EA7\u4E3A\u529F\u80FD\u9A8C\u8BC1\u6216\u5B98\u65B9\u8BA4\u8BC1\u3002",
  "library_material": {
    "organization": "organized",
    "semantic_state": "classified",
    "semantic_category": "\u8F6F\u4EF6\u4F9B\u5E94\u94FE\uFF0Fnpm \u516C\u5171\u5305\u4E0E\u7248\u672C\u5143\u6570\u636E",
    "evidence_grade": "documentation_only",
    "attachments": [
      {
        "material_id": "material-5a8c954f0650f79072debdaa2f6ddc2d",
        "source_url": "https://github.com/npm/registry/blob/main/docs/REGISTRY-API.md",
        "content_sha256": "48687ce7b8ea48f3304d1be82bd567ff366fd59204a03cad2d48e0ffef8cf6ae",
        "decoded_bytes": 309562,
        "content_type": "text/html",
        "captured_at": "2026-10-24T17:06:15.4527040\u002B00:00",
        "text_representation": "decoded_text_utf8",
        "text_utf8_sha256": "48687ce7b8ea48f3304d1be82bd567ff366fd59204a03cad2d48e0ffef8cf6ae",
        "text_utf8_bytes": 309562,
        "capture_body_reconstructed": true,
        "read_path": "/api/v1/capabilities/cap-0806525017377ae56c25dfbc/materials/material-5a8c954f0650f79072debdaa2f6ddc2d?version=1"
      }
    ]
  },
  "last_correction": {
    "contribution_id": "contribution-77182a8d0278424d8edaba68fabf2df1",
    "reason": "\u4F9D\u636E\u672C\u6279 npm \u5B98\u65B9 REGISTRY-API.md \u9644\u4EF6\u7684 Objects\u3001Package Endpoints \u548C\u641C\u7D22\u53C2\u6570\u6574\u7406\uFF1B\u79FB\u9664\u672A\u6574\u7406\u6807\u7B7E\u3002\u5B8C\u6574 API base URL\u3001\u8BA4\u8BC1\u3001\u6536\u8D39\u53CA\u9650\u6D41\u672A\u7531\u672C\u9875\u660E\u786E\uFF0C\u4FDD\u7559 unknown\uFF0C\u4E0D\u4ECE tarball \u6A21\u677F\u6216\u65E2\u6709\u77E5\u8BC6\u8865\u5199\u8C03\u7528\u5730\u5740\u3002",
    "source_urls": [
      "https://github.com/npm/registry/blob/main/docs/REGISTRY-API.md"
    ],
    "reported_by": "contributor"
  },
  "version_read_basis": "archived_revision",
  "deep_read": {
    "schema_version": "navonavo.capability-read.v1",
    "card_id": "cap-0806525017377ae56c25dfbc",
    "card_version": 2,
    "selected_profile_id": null,
    "state": "not_checked",
    "review_state": null,
    "read_url": "https://navonavo.com/api/v1/capabilities/cap-0806525017377ae56c25dfbc?version=2",
    "page_url": "https://navonavo.com/capabilities/cap-0806525017377ae56c25dfbc?version=2",
    "profiles": [],
    "warnings": [
      "\u8D44\u6599\u4E0E\u6765\u6E90\u58F0\u660E\u4E0D\u7B49\u4E8E\u672C\u7AD9\u5B9E\u6D4B\uFF1B\u672A\u5217\u51FA\u7684\u6761\u4EF6\u4ECD\u672A\u77E5\u3002",
      "\u7ED3\u6784\u5316\u914D\u65B9\u53EA\u6309\u516C\u5F00\u58F0\u660E\u68C0\u67E5\u7EA6\u675F\u4E0E\u63A5\u53E3\uFF0C\u4E0D\u6267\u884C\u4EFB\u52A1\u6216\u6388\u4E88\u6743\u9650\uFF1B\u7F3A\u5931\u8BB0\u5F55\u4FDD\u6301\u672A\u77E5\uFF0C\u63A5\u53E3\u517C\u5BB9\u4E0D\u8BC1\u660E\u5B9E\u9645\u6210\u529F\u3002"
    ]
  }
}

Submit another public source · Privacy and disclosure