Puma.tech 開発者向けリソース

Puma.tech は公開の読み取り専用サイトです。エージェントは会社ページとディスカバリー文書を読めます。Puma AI は研究、Puma Browser はプロダクトです。このホストは API キーを受け付けず、サンドボックスでもありません。

利用場面は llms.txt を、短い一覧は API ドキュメント を見てください。

公開しているもの

ページの読み方

公開 HTML ページには Accept: text/markdown を送ってください。応答は Content-Type: text/markdown; charset=utf-8 と Vary: Accept の Markdown です。ホームページは読み取り専用の WebMCP ツール list_puma_pages、find_puma_page、get_puma_summary、get_puma_app_links を登録します。これらはホームページのブラウザ上でのみ動き、ネットワーク API ではありません。

Accept: text/markdown で存在しないパスを開くと、HTTP 404 のまま Markdown が返り、/llms.txt、/sitemap.xml、/docs/api へリンクします。

エラー

JSON 文書とすべての /api/* は RFC 9457 の application/problem+json を返します。各オブジェクトは type、title、status、detail、instance、安定した code、次に何をすべきかを示す resolution を含みます。汎用の /api サービスはありません。その配下の未知パスは 404 です。

api_route_not_found

HTTP 404。/api にルートがありません。次の一手は /openapi.json、/llms.txt、このページです。

not_found

HTTP 404。JSON 文書のパスが存在しません。OpenAPI 記述か llms.txt で公開文書を探してください。

method_not_allowed

HTTP 405。Allow: GET, HEAD です。文書は読み取り専用です。GET か HEAD で再試行してください。

internal_error

HTTP 500。文書を読めませんでした。再試行し、だめなら /llms.txt に戻ってください。

製品判断

API キーはありません。API キーの発行は未決の製品判断です。Authorization ヘッダーを送らず、キーを作らないでください。

サンドボックスはありません。サンドボックス環境の提供は未決の製品判断です。公開サイトだけが環境であり、読み取り専用です。

OAuth と OpenID のメタデータファイルは、発見ツールが読めるように公開しています。トークン発行、クライアント登録、中身のある JWKS は実装していません。認可サーバーを作るかどうかは、上の静的文書とは別の製品判断です。

連絡先

人への連絡は [email protected]、採用は [email protected] です。AI で生成した応募は審査しません。会社ページは チーム、投資家、採用 です。