DOI 查询

把一个 DOI 解析为元数据记录（标题、年份、出版方、类型、作者、链接）；找不到时 found 为 false。


接口	`POST /v1/doi-lookups`
所需权限	`doi_lookup:lookup`
MCP 工具	`doi_lookup`
计量单位	`records`

计量单位出现在 execution.usage.units 中，用于对账和计费。

请求字段

字段	类型	必填	说明
`invocation_id`	string	是	调用方（市场）生成的调用 ID：同一个 ID 在同一操作上只执行一次，用同一 ID 重试会被拒绝而不会重复计费。1–128 个字符，可用 A-Z a-z 0-9 . _ : -。
`provider`	string	是	处理本次请求的数据源，按下方数据源表的覆盖范围选择。可选值：`datacite`
`doi`	string	是	DOI，格式为 10.<注册者>/<后缀>，可带 https://doi.org/、https://dx.doi.org/ 或 doi: 前缀，最多 300 个字符。

数据源

数据源	区域	说明	限制
`datacite`	DE	DataCite，覆盖 DataCite 注册的 DOI（数据集、软件等）	`timeout_seconds`: 30

示例

curl -sS https://services.zgi.im/v1/doi-lookups \
  -H "Authorization: Bearer $ZGI_SERVICES_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"invocation_id": "docs-1791778521-doi_lookup", "provider": "datacite", "doi": "10.5438/0012"}'

POST /v1/doi-lookups HTTP/1.1
Host: services.zgi.im
Authorization: Bearer <token>
Content-Type: application/json

{
  "invocation_id": "docs-1791778521-doi_lookup",
  "provider": "datacite",
  "doi": "10.5438/0012"
}

通过 MCP 调用时，工具参数与 HTTP 请求体完全相同。

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "doi_lookup",
    "arguments": {
      "invocation_id": "docs-1791778521-doi_lookup",
      "provider": "datacite",
      "doi": "10.5438/0012"
    }
  }
}

curl -sS https://services.zgi.im/v1/mcp \
  -H "Authorization: Bearer $ZGI_SERVICES_TOKEN" \
  -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2025-11-25' \
  -d @request.json

以下为一次真实调用的返回，列表只保留前两项，长文本已截断。

{
  "code": 0,
  "message": "success",
  "data": {
    "execution": {
      "id": "exe_01a12e52943c77ddb4bd0f2953dfd014",
      "invocation_id": "docs-1791778521-doi_lookup",
      "capability": "doi_lookup",
      "operation": "doi_lookup.lookup",
      "provider": "datacite",
      "outcome": "succeeded",
      "error_category": null,
      "error_code": null,
      "usage": {
        "provider_requests": 1,
        "units": [
          {
            "name": "records",
            "value": 1,
            "source": "measured"
          }
        ]
      },
      "upstream_ref": null,
      "request_id": "req_302c19f0d97515daaa5ff739",
      "started_at": "2026-10-12T04:15:26.268512227Z",
      "finished_at": "2026-10-12T04:15:26.91534647Z",
      "duration_ms": 646
    },
    "result": {
      "found": true,
      "record": {
        "doi": "10.5438/0012",
        "title": "DataCite Metadata Schema Documentation for the Publication and Citation of Research Data v4.0",
        "year": 2016,
        "publisher": "DataCite e.V.",
        "type": "Documentation",
        "authors": [
          "DataCite Metadata Working Group"
        ],
        "url": "https://schema.datacite.org/meta/kernel-4.0/index.html",
        "is_open_access": null,
        "open_access_url": null,
        "license": null,
        "resource_type_general": "Text"
      },
      "source": {
        "name": "DataCite",
        "license": "CC0-1.0",
        "url": "https://datacite.org"
      }
    }
  }
}