Theneo

Theneoは、APIリファレンス、変更履歴、ブランド対応の開発者ポータルを備えた開発者向けドキュメントプラットフォームです。API仕様や接続リポジトリから、公開・非公開ドキュメントを生成、共同編集、公開できます。

概要

Theneoは、APIリファレンス、開発者ポータル、変更履歴、プライベートなカスタマーポータルを1か所で構築できる開発者向けドキュメントプラットフォームです。製品の変更に合わせて、ドキュメント、ガイド、API運用を整合させたいチーム向けに位置付けられています。

このサイトは、共同作業と自動更新を重視しています。TheneoはAPI仕様や接続済みリポジトリからドキュメントを生成でき、リアルタイムの共同編集をサポートし、Try-itコンソール、AI支援による説明、変更履歴生成、公開または非公開ドキュメント向けのアクセス制御などのツールを備えています。

主な機能

APIリファレンスの自動生成

OpenAPIファイル、Postmanコレクション、またはGraphQLスキーマをアップロードするか、Gitリポジトリを接続すると、Theneoがエンドポイントの説明、例、コードサンプルを含むインタラクティブなドキュメントを生成します。

インタラクティブなAPIテスト

組み込みのTry-itコンソールにより、読者はドキュメントからライブリクエストを送信でき、一般的な認証方式と複数の環境をサポートします。

変更追跡とリリースノート

Git同期のワークフローは、仕様変更を検出し、ドキュメントを再構築し、プレビュー公開、承認ステップ、変更履歴の生成をサポートします。

リアルタイム共同作業

エンジニア、PM、ライターは、インラインコメント、役割ベースの権限、バージョン比較、ライブ共同編集を備えた共有環境で一緒に編集できます。

公開および非公開ポータル

Theneoは、ブランド対応の公開ドキュメント、非公開ポータル、パートナーポータル、顧客ごとのアクセス制御をサポートしており、表示レベルを分けたいチームに適しています。

ブランディングとポータルのカスタマイズ

このプラットフォームは、カスタムドメイン、ブランディング制御、テンプレート、ホワイトラベルオプションをサポートしており、ドキュメントを製品のアイデンティティに合わせたいチーム向けです。

一般的な使用例

仕様からAPIドキュメントを生成する
チームはAPI仕様をアップロードするかリポジトリを接続して、例、説明、Try-itコンソールを備えた構造化されたリファレンスを、手動でドキュメントを作成することなく生成できます。
部門をまたいで共同作業する
製品、エンジニアリング、テクニカルライティングの各チームは、同じドキュメントセットを一緒に編集し、コメントを解決し、バージョン管理された変更を1つのワークフローで管理できます。
公開または非公開の開発者ポータルを運用する
パートナーや顧客向けAPIを公開する企業は、アクセス制限付きのブランドポータル、顧客固有の表示設定、複数のドキュメント表示面を備えたポータルを公開できます。
更新を追跡して変更履歴を公開する
頻繁にAPI変更をリリースするチームは、自動変更履歴生成、破壊的変更の検出、プレビュー/承認フローを使用して、リリースノートを最新に保てます。
対象者ごとにアクセスを制御する
エンタープライズや規制産業の購入者に対応する組織は、アクセス制御、SSO関連オプション、ワークスペース権限を使用して、対象者を分け、誰が何を閲覧できるかを管理できます。

Pros and Cons

Pros

一般的な仕様形式や接続済みリポジトリから、インタラクティブなAPIドキュメントを生成できます。
APIリファレンス、ガイド、変更履歴、開発者ポータルを1つのプラットフォームにまとめています。
コメント、権限、バージョン管理、承認ワークフローを備えたリアルタイム共同作業をサポートします。
アクセス制御付きで、公開ドキュメントとプライベートなカスタマーポータルの両方に対応します。
AI支援によるドキュメント作成、セマンティック検索、変更履歴の下書き作成機能を備えています。

Cons

高度な機能であるセルフホスティング、SAML SSO、カスタムロール、専用サポートは、上位ティアまたはエンタープライズプランで提供されると記載されています。
対応範囲はAPIドキュメントと開発者ポータルに最も強く、Gitやいくつかのワークフローツール以外のサードパーティ統合についてはソースの詳細が少なめです。

FAQ

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には無料プランまたは有料プランがありますか？

料金ページには、無料のスターターティア、有料のビジネスおよびグロースティア、そしてカスタム価格のエンタープライズプランが記載されています。料金の詳細では、ブランディング、アクセス制御、サポートに関する上位ティアのオプションにも言及されています。

Quick Facts

カテゴリ: 開発者向けツール
主な用途: APIドキュメントと開発者ポータルの管理
ソースドメイン: theneo.io
デプロイモデル: 上位ティアでセルフホスティングが利用可能なクラウドプラットフォーム
ドキュメントの種類: APIリファレンス、ガイド、変更履歴、カスタマーポータル
価格: 無料ティアあり。有料プランとカスタムのエンタープライズ価格が記載されています