所有者の詳細 URL テンプレート

所有者プロファイル ページを持つパッケージ フィードは、このテンプレートを使用してプロファイル URL を構築する方法をクライアント ツールに通知できます。 これは、パッケージ ソースが、特定のパッケージ所有者のプロファイル ページにリンクするすべてのクライアント エクスペリエンス (サード パーティも含む) を有効にする場合に便利です。

この URL の構築に使用されるリソースは、サービス インデックスで見つかったOwnerDetailsUriTemplate リソースです。

バージョン管理

次の @type 値が使用されます。

@type 値 Notes
OwnerDetailsUriTemplate/6.11.0 最初のリリース

URL テンプレート

次の API の URL は、前述のリソース@type値のいずれかに関連付けられている@id プロパティの値です。

たとえば、nuget.org の所有者の詳細テンプレートは次のようになります。

https://www.nuget.org/profiles/{owner}

HTTP メソッド

クライアントは、ユーザーに代わって所有者の詳細 URL に要求を行うことを意図していませんが、Web ページでは、クリックされた URL を Web ブラウザーで簡単に開くために、 GET メソッドをサポートする必要があります。

URL を構築する

検索リソースは、所有者ユーザー名を含むパッケージ所有者情報を返します。 検索リソースの所有者ユーザー名を指定すると、クライアント実装は Web インターフェイスへのアクセスに使用する URL を構築できます。 クライアント実装では、この構築された URL (またはクリック可能なリンク) をユーザーに表示し、WEB ブラウザーを開いて URL を開き、所有者の詳細を確認できるようにする必要があります。 所有者の詳細ページの内容は、サーバーの実装によって決まります。

URL は絶対 URL である必要があり、スキーム (プロトコル) は HTTPS である必要があります。

サービス インデックスの @id の値は、次のプレースホルダー トークンを含む URL 文字列です。

URL プレースホルダー

名前 タイプ 必須 Notes
{owner} 文字列 はい 詳細を取得する所有者ユーザー名

クライアントは、他の API 応答またはパッケージ リポジトリ署名で見つかった形式に関係なく、ユーザー名の大文字と小文字を保持する必要があります。 NuGet.org は所有者のユーザー名を大文字と小文字を区別せずに扱いますが、すべてのパッケージ ソースにこの柔軟性があるわけではありません。

たとえば、クライアント実装で所有者 Microsoftの所有者の詳細ページへのリンクを表示する必要がある場合は、次の URL が生成され、ユーザーに提供されます。

https://www.nuget.org/profiles/Microsoft