# Theneo APIリファレンスや変更履歴、ブランド開発者ポータル向けの開発者ドキュメント - Findings24: - ウェブサイト: - 料金: Freemium - カテゴリー: AIドキュメント生成ツール ## Theneoとは？ Theneoは、APIリファレンス、開発者ポータル、変更履歴、プライベートなカスタマーポータルを1か所で構築できる開発者向けドキュメントプラットフォームです。製品の変更に合わせて、ドキュメント、ガイド、API運用を整合させたいチーム向けに位置付けられています。 このサイトは、共同作業と自動更新を重視しています。TheneoはAPI仕様や接続済みリポジトリからドキュメントを生成でき、リアルタイムの共同編集をサポートし、Try-itコンソール、AI支援による説明、変更履歴生成、公開または非公開ドキュメント向けのアクセス制御などのツールを備えています。 ## Theneoでできること ### APIリファレンスの自動生成 OpenAPIファイル、Postmanコレクション、またはGraphQLスキーマをアップロードするか、Gitリポジトリを接続すると、Theneoがエンドポイントの説明、例、コードサンプルを含むインタラクティブなドキュメントを生成します。 ### インタラクティブなAPIテスト 組み込みのTry-itコンソールにより、読者はドキュメントからライブリクエストを送信でき、一般的な認証方式と複数の環境をサポートします。 ### 変更追跡とリリースノート Git同期のワークフローは、仕様変更を検出し、ドキュメントを再構築し、プレビュー公開、承認ステップ、変更履歴の生成をサポートします。 ### リアルタイム共同作業 エンジニア、PM、ライターは、インラインコメント、役割ベースの権限、バージョン比較、ライブ共同編集を備えた共有環境で一緒に編集できます。 ### 公開および非公開ポータル Theneoは、ブランド対応の公開ドキュメント、非公開ポータル、パートナーポータル、顧客ごとのアクセス制御をサポートしており、表示レベルを分けたいチームに適しています。 ### ブランディングとポータルのカスタマイズ このプラットフォームは、カスタムドメイン、ブランディング制御、テンプレート、ホワイトラベルオプションをサポートしており、ドキュメントを製品のアイデンティティに合わせたいチーム向けです。 ## 利用シーン ### 仕様からAPIドキュメントを生成する チームはAPI仕様をアップロードするかリポジトリを接続して、例、説明、Try-itコンソールを備えた構造化されたリファレンスを、手動でドキュメントを作成することなく生成できます。 ### 部門をまたいで共同作業する 製品、エンジニアリング、テクニカルライティングの各チームは、同じドキュメントセットを一緒に編集し、コメントを解決し、バージョン管理された変更を1つのワークフローで管理できます。 ### 公開または非公開の開発者ポータルを運用する パートナーや顧客向けAPIを公開する企業は、アクセス制限付きのブランドポータル、顧客固有の表示設定、複数のドキュメント表示面を備えたポータルを公開できます。 ### 更新を追跡して変更履歴を公開する 頻繁にAPI変更をリリースするチームは、自動変更履歴生成、破壊的変更の検出、プレビュー/承認フローを使用して、リリースノートを最新に保てます。 ### 対象者ごとにアクセスを制御する エンタープライズや規制産業の購入者に対応する組織は、アクセス制御、SSO関連オプション、ワークスペース権限を使用して、対象者を分け、誰が何を閲覧できるかを管理できます。 ## よくある質問 ### TheneoはどのようにしてドキュメントをAPIの変更と同期しますか？ Theneoは、OpenAPI/Swagger、Postman、GraphQLの入力からAPIリファレンスドキュメントを生成でき、GitやCI/CDワークフローを通じて同期を維持することもできます。ソース資料では、更新のためのWebエディター公開と承認ステップについても説明されています。 ### TheneoはどのAPI形式をサポートしていますか？ ソースでは、APIドキュメント生成向けにOpenAPI 2.0および3.x、Swagger、Postmanコレクション、GraphQLスキーマが明示的にサポートされています。 ### 読者はTheneoのドキュメント内でAPIを直接テストできますか？ はい。Theneoには、ドキュメントから直接ライブテストできる組み込みのTry-itコンソール / API Explorerがあり、APIキー、OAuth 2.0、OIDC、サンドボックスおよび本番環境、カスタムヘッダー、機密値のマスキングをサポートしているとソースに記載されています。 ### Theneoは公開ドキュメントと非公開ドキュメントの両方をサポートしていますか？ はい。料金ページと製品ページでは、公開ドキュメント、非公開ドキュメント、パスワード保護されたプロジェクト、カスタマーポータル、SSOや招待などのアクセス制御が説明されています。 ### Theneoには無料プランまたは有料プランがありますか？ 料金ページには、無料のスターターティア、有料のビジネスおよびグロースティア、そしてカスタム価格のエンタープライズプランが記載されています。料金の詳細では、ブランディング、アクセス制御、サポートに関する上位ティアのオプションにも言及されています。 ## クイック情報 - **カテゴリ**: 開発者向けツール - **主な用途**: APIドキュメントと開発者ポータルの管理 - **ソースドメイン**: theneo.io - **デプロイモデル**: 上位ティアでセルフホスティングが利用可能なクラウドプラットフォーム - **ドキュメントの種類**: APIリファレンス、ガイド、変更履歴、カスタマーポータル - **価格**: 無料ティアあり。有料プランとカスタムのエンタープライズ価格が記載されています