URL-Vorlage für Besitzerdetails

Paketfeeds mit Besitzerprofilseiten können Clienttools darüber informieren, wie die Profil-URL über diese Vorlage erstellt wird. Dies ist nützlich, wenn eine Paketquelle alle Clienterfahrungen (auch Drittanbieter) aktivieren möchte, um eine Verknüpfung mit der Profilseite eines bestimmten Paketbesitzers zu erstellen.

Die Zum Erstellen dieser URL verwendete Ressource ist die OwnerDetailsUriTemplate Ressource im Dienstindex.

Versioning

Die folgenden @type Werte werden verwendet:

@type Wert Notes
OwnerDetailsUriTemplate/6.11.0 Die erste Version

URL-Vorlage

Die URL für die folgende API ist der Wert der Eigenschaft, die @id einem der oben genannten Ressourcenwerte @type zugeordnet ist.

Beispielsweise sieht die Besitzerdetailsvorlage von nuget.org wie folgt aus:

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

HTTP-Methoden

Obwohl der Client nicht beabsichtigt ist, Anforderungen an die Url der Besitzerdetails im Namen des Benutzers zu senden, sollte die Webseite die GET Methode unterstützen, damit eine angeklickte URL in einem Webbrowser leicht geöffnet werden kann.

Erstellen der URL

Die Suchressource gibt Paketbesitzerinformationen zurück, einschließlich Besitzerbenutzernamen. Angesichts eines Besitzerbenutzernamens aus der Suchressource kann die Clientimplementierung eine URL erstellen, die für den Zugriff auf eine Webschnittstelle verwendet wird. Die Clientimplementierung sollte diese konstruierte URL (oder klickbare Verknüpfung) für den Benutzer anzeigen, sodass er einen Webbrowser mit der URL öffnen und mehr über den Besitzer erfahren kann. Der Inhalt der Seite "Besitzerdetails" wird durch die Serverimplementierung bestimmt.

Die URL muss eine absolute URL sein, und das Schema (Protokoll) muss HTTPS sein.

Der Wert des @id Dienstindexes ist eine URL-Zeichenfolge, die das folgende Platzhaltertoken enthält:

URL-Platzhalter

Name Type Erforderlich Notes
{owner} string yes Der Benutzername des Besitzers, um Details zu erhalten

Der Client sollte die Groß-/Kleinschreibung des Benutzernamens in beliebiger Form beibehalten, die er in anderen API-Antworten oder in der Paket-Repositorysignatur gefunden wurde. NuGet.org behandelt Benutzernamen des Besitzers in unsensitiver Weise, aber nicht alle Paketquellen haben diese Flexibilität.

Wenn die Clientimplementierung z. B. einen Link zur Besitzerdetailseite für den Besitzer Microsoftanzeigen muss, wird die folgende URL erstellt und dem Benutzer bereitgestellt:

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