開発者・エージェント向けリソース
Ivy が公開している機械可読ドキュメントを一箇所に。キーも登録も、レート上限の交渉も不要です。以下のエンドポイントはすべて公開 GET です。
Ivy は、人と同じくらい手軽にソフトウェアからも利用できるよう作られています。サイトは公開サーフェスの OpenAPI 3.1 記述、回答エンジン向けの llms.txt 要約、/.well-known/ 配下のディスカバリ文書、そして Accept ヘッダーのネゴシエーションによる各マーケティングページの text/markdown 版を提供します。このページに載っているものはすべて安定・バージョン管理済みで、自動化の対象にして問題ありません。
API 仕様
公開 API の機械可読な記述です。どちらの文書も単一のソースから生成されるため、内容がずれることはありません。
公開エージェント API
Ivy とは何か、エージェントはいつ使うべきか、どこから入手できるかを示す、認証不要の JSON エンドポイント 4 種。
回答エンジン向けリソース
llms.txt の慣例に沿って、大規模言語モデル向けに書かれたプレーンテキストの要約。
ディスカバリ文書
どこに何があるかを教えられなくてもクライアントが自力で構成できる、well-known URI。
Markdown コンテントネゴシエーション
任意のマーケティングページに Accept: text/markdown を送ると、HTML ではなく整った Markdown が返ります。スクレイピングも DOM 解析も不要です。acceptmarkdown.com の慣例に従っています。
curl -H 'Accept: text/markdown' https://ivy.app/productレート制限
公開エンドポイントは IETF ドラフト標準の RateLimit ヘッダーでリクエスト枠を通知します。遮断されて初めて上限に気づくのではなく、事前に把握できます。文書はキャッシュから配信され 1 時間ごとに再検証されるため、Cache-Control を尊重するクライアントが枠を使い切ることはありません。万一超過した場合は、Retry-After ヘッダーと RFC 9457 の problem 文書を伴う 429 を返します。
バージョニングと廃止予定
エージェントのエンドポイントはパスでバージョン管理されます（/api/v1/）。互換性を壊す変更は既存バージョンを書き換えるのではなく、新しいバージョンとして提供します。オペレーションを廃止する際は、まず OpenAPI 文書で deprecated と示し、削除前に最低 180 日間 Deprecation および Sunset ヘッダーを返します（RFC 9745、RFC 8594 に準拠）。