Torna 1.24.0 をリリースしました このリリースの内容は次のとおりです。
【新しい】
- フィールドレベルまで正確なドキュメント変更レコードの表示をサポートし、マークダウンドキュメントとリッチテキストドキュメントのコンテンツ比較をサポートします。
- リクエスト前にパラメータ情報を動的に処理するためのプレスクリプトとポストスクリプトを追加しました。
- 新しいドキュメント ステータス フィールド (未開始、進行中、完了) を追加し、ステータス変更時の DingTalk プッシュをサポートします
- ドキュメントのコンテンツの変更は DingTalk グループにプッシュでき、@someone にすることができます。
- カスタム パラメータ タイプのサポート (ドロップダウン ボックス編集可能)
【修理】
- 未読メッセージには 10 件の質問しか表示できません
このアップグレードの焦点は、ドキュメントの変更レコードを表示することです。ドキュメント プレビュー インターフェイスの右上隅にある をクリックして表示します。
変更履歴のポップアップ:
さらに、リッチ テキスト ドキュメントとマークダウン ドキュメントはコンテンツの比較をサポートします。
ドキュメントのコンテンツが変更された後、DingTalk グループにプッシュできます。
バージョン 1.24.0 では、リクエストの前処理が追加されています。これにより、インターフェイスをリクエストする前にトークンの取得やパラメータの暗号化など、リクエスト パラメータやその他の情報を動的に変更できます。
特定の用途のために、Torna を導入して体験することができます~
トルナについて
インターフェイス ドキュメント ソリューションは、インターフェイス ドキュメントの管理をより便利かつ迅速にすることを目的としています。Torna は、チームのコラボレーションを使用してインターフェース文書を管理および保守し、さまざまな形式の文書を統合保守に組み込みます。
Torna は、従来の文書生成ツール (swagger など) の欠点を補い、オリジナルの機能を維持しつつ、いくつかの実用的な機能を強化および強化します。
文書管理の問題点を解決する
- Swagger ドキュメントのプレビュー ページとデバッグ ページのプレゼンテーションに満足していない
- 私は、swagger の押し付けがましい注釈が好きではありません。
- javadoc コメントを使用してドキュメントを生成し、インターフェイスのデバッグを実行したいと考えています。
- 企業のすべてのプロジェクトインターフェース文書を統一的に管理できることが望まれます。
- プロジェクト内のいくつかのドキュメントをサードパーティの発信者に提供して閲覧できるようにしたいと考えています。
- プロジェクト内の辞書列挙を統一的に管理できることを期待します
上記のニーズと問題点がある場合は、Torna を使用してみてください。
おすすめの組み合わせ
文書プロセス全体の自動化を実現するsmart-doc + Torna
Java言語を使用する場合は、次の使用をお勧めします。 smart-doc + Torna
Smart-doc + Torna は、業界をリードするドキュメント生成および管理ソリューションを形成します。Smart-doc は、侵入することなく Java ソース コードとコメントを抽出して API ドキュメントを生成し、そのドキュメントを Torna エンタープライズ レベルのインターフェイス ドキュメント管理プラットフォームに自動的にプッシュするために使用されます。 。
この組み合わせにより、Java アノテーションを記述するだけでインターフェース情報を Torna プラットフォームにプッシュすることができ、インターフェースのプレビューやインターフェースのデバッグを実現します。
プッシュされたコンテンツは次のとおりです。接口名称/author/Path参数/Header/请求参数/返回参数/字典列表/公共错误码
Java 以外の言語を使用している場合は、フォーム ページを使用して上記の内容を編集し、完了後にインターフェイスをプレビューおよびデバッグすることもできます。