depsdotdev

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

deps.dev API

deps.dev API

Use this skill to map package coordinates (
system/name/version
) to high-signal dependency intelligence from Open Source Insights.
使用此技能将包坐标(
system/name/version
)映射到来自Open Source Insights的高价值依赖情报。

Start Here

入门指南

  • Prefer stable API base:
    https://api.deps.dev/v3
  • Use
    v3alpha
    only when you need purl and batch endpoints
  • Percent-encode all path/query values before sending requests
  • Use canonical values returned in responses (
    packageKey
    ,
    versionKey
    ,
    projectKey
    ) for follow-up calls
  • 优先使用稳定API基础地址:
    https://api.deps.dev/v3
  • 仅当需要purl和批量端点时才使用
    v3alpha
  • 在发送请求前,对所有路径/查询值进行百分号编码
  • 在后续调用中使用响应中返回的标准值(
    packageKey
    ,
    versionKey
    ,
    projectKey

Fast Routing

快速路由

If you need to...UseRead
List versions for a package
GetPackage
references/endpoint-map.md
Inspect one version (licenses, advisories, links)
GetVersion
references/endpoint-map.md
Get declared constraints
GetRequirements
references/endpoint-map.md
Get resolved dependency graph
GetDependencies
references/endpoint-map.md
Map project repo to package versions
GetProjectPackageVersions
references/endpoint-map.md
Query by file hash or exact version key
Query
references/endpoint-map.md
Avoid encoding mistakesURL/purl rules
references/request-shapes-and-encoding.md
Handle limits and error casesbatch/query limits
references/limits-errors-and-reliability.md
Use purl/batch/dependents
v3alpha
features
references/v3alpha-extras.md
如果你需要...使用参考文档
列出某个包的版本
GetPackage
references/endpoint-map.md
查看单个版本信息(许可证、安全公告、链接)
GetVersion
references/endpoint-map.md
获取声明的约束条件
GetRequirements
references/endpoint-map.md
获取已解析的依赖关系图
GetDependencies
references/endpoint-map.md
将项目仓库映射到包版本
GetProjectPackageVersions
references/endpoint-map.md
通过文件哈希或确切版本键进行查询
Query
references/endpoint-map.md
避免编码错误URL/purl规则
references/request-shapes-and-encoding.md
处理限制和错误情况批量/查询限制
references/limits-errors-and-reliability.md
使用purl/批量/依赖项
v3alpha
功能
references/v3alpha-extras.md

Minimal Workflow

最简工作流程

  1. Normalize user input into
    {system, name, version?}
    .
  2. Call
    GetPackage
    if version is missing; prefer
    isDefault
    or newest published version.
  3. Call
    GetVersion
    for license/advisory/provenance metadata.
  4. Add
    GetRequirements
    and
    GetDependencies
    when user asks "declared" vs "resolved" dependency questions.
  5. If input is a hash or purl, use
    Query
    or
    v3alpha
    purl endpoints.
  1. 将用户输入标准化为
    {system, name, version?}
  2. 如果缺少版本信息,调用
    GetPackage
    ;优先使用
    isDefault
    版本或最新发布的版本。
  3. 调用
    GetVersion
    获取许可证/安全公告/来源元数据。
  4. 当用户询问“声明的”与“已解析的”依赖问题时,添加
    GetRequirements
    GetDependencies
    调用。
  5. 如果输入是哈希或purl,使用
    Query
    v3alpha
    的purl端点。

Examples

示例

  • Curl patterns and jq snippets:
    examples/curl-cheatsheet.md
  • Curl示例和jq代码片段:
    examples/curl-cheatsheet.md

External Docs

外部文档