API / バージョン 1

安定した JSON のエビデンス。

公開 API は、ウェブサイトと同じタイムスタンプ付きの観測を公開します。読み取り専用で、キーやアカウントは必要ありません。

リクエストとキャッシュ

すべてのレスポンスは application/json で、Cache-Control: public, s-maxage=60, stale-while-revalidate=300 を伴います。このヘッダーに従うことはコストがかからず、インデックスを安価に提供し続けられるため、ポーリングではなくキャッシュから読み取ってください。提供されるのは GET と HEAD のみで、その他のメソッドは Allow ヘッダーを伴う 405 を返します。

エラーが裸のステータスを返すことはありません。本文は常に、分岐に安全な code と、人に向けて書かれた message を持つオブジェクトです:

{ "error": { "code": "invalid_limit", "message": "limit must be an integer from 1 to 100" } }

サーバーの一覧

GET /api/v1/servers

q: タイトル、Registry 名、説明に対して照合される自由テキスト。
state: verified、stale、broken、auth_required、unverifiable のいずれか。
package: パッケージレジストリの種類: npm、pypi、oci。
transport: Registry レコードで宣言されたトランスポート（例: stdio）。
client: クライアントのスラッグ（Clients に記載されているとおり。例: claude-code）。公開 API
limit: 1 から 100 までの整数。デフォルトは 25。この範囲外の値は丸められるのではなく拒否されるため、クライアントが要求した行数と異なる行数を通知なしに渡されることはありません。
cursor: 前のレスポンスの nextCursor。最初のページでは省略し、最後のページでは null になります。

GET /api/v1/servers?state=verified&package=npm&limit=2

{
  "data": [
    {
      "id": "srv_01J…",
      "registryName": "example/one",
      "title": "Example Server",
      "description": "What the server says it does.",
      "state": "verified",
      "observedAt": "2026-09-15T00:00:00.000Z",
      "toolCount": 3,
      "url": "/servers/example/one"
    }
  ],
  "nextCursor": null
}

サーバーの詳細

GET /api/v1/servers/:namespace/:name

1 つのサーバーについて、Registry のメタデータ、実行可能なパッケージ、公開された観測履歴を data の下に返します。その履歴の各実行は、テストした正確なパッケージバージョンを示しており、通常それは現在公開されているバージョンではありません。不明なペアは、コード not_found を伴う 404 を返します。

検証実行

GET /api/v1/verification-runs/:id

識別子による 1 件の観測。確認ルールを通過していない実行はここには存在せず、コード not_found を伴う 404 を返します。これは、存在しなかった実行と同じ答えです。両者の違いがあれば、ルールが伏せるために存在する失敗を開示してしまうからです。

データセットの統計

GET /api/v1/stats

{ "data": { "indexedServers": 979, "verifiedServers": 0, "observedAt": null } }

エラーコード

invalid_limit: 400 — limit が 1 から 100 までの整数ではありませんでした。
invalid_cursor: 400 — カーソルが不正であるか、異なる並べ替え順に対して作成されました。最初のページからやり直してください。
not_found: 404 — そのようなサーバーは存在しないか、その識別子を持つ公開可能な実行がありません。
method_not_allowed: 405 — API は読み取り専用です。レスポンスは提供されるメソッドを示します。

公開されないもの

内部の stderr、ワーカーのリース、確認待ちの詳細は決して公開されず、状態には常に、それを記述する観測のタイムスタンプが伴い、あなたが要求した時刻ではありません。