Modelo de URL de dados do proprietário

Feeds de pacotes que tenham páginas de perfil de proprietário podem informar as ferramentas do cliente sobre como construir o URL do perfil através deste modelo. Isto é útil quando o código-fonte de um pacote quer permitir que todas as experiências dos clientes (mesmo de terceiros) liguem para a página de perfil de um proprietário específico do pacote.

O recurso utilizado para construir este URL é o OwnerDetailsUriTemplate recurso encontrado no índice de serviço.

Versioning

São utilizados os seguintes @type valores:

@type valor Notes
OwnerDetailsUriTemplate/6.11.0 O lançamento inicial

Modelo de URL

O URL da API seguinte é o valor da @id propriedade associada a um dos valores de recurso @type mencionados.

Por exemplo, o modelo de dados do proprietário do nuget.org é assim:

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

Métodos HTTP

Embora o cliente não tenha a intenção de fazer pedidos ao URL de dados do proprietário em nome do utilizador, a página web deve suportar o GET método que permite que uma URL em que se clique seja facilmente aberta num navegador web.

Construa a URL

O recurso de pesquisa devolve informações sobre o proprietário do pacote, incluindo nomes de utilizador do proprietário. Dado um nome de utilizador proprietário proveniente do recurso de pesquisa, a implementação cliente pode construir uma URL usada para aceder a uma interface web. A implementação do cliente deve mostrar este URL construído (ou link clicável) ao utilizador, permitindo-lhe abrir um navegador web para o URL e aprender mais sobre o proprietário. O conteúdo da página de detalhes do proprietário é determinado pela implementação do servidor.

O URL deve ser um URL absoluto e o esquema (protocolo) deve ser HTTPS.

O valor do @id no índice do serviço é uma cadeia de URL contendo o seguinte token de substituição:

Espaços reservados para URL

Name Tipo Obrigatório Notes
{owner} cadeia (de caracteres) yes O nome de utilizador do proprietário para obter detalhes de

O cliente deve manter a maiúscula do nome de utilizador na forma em que foi encontrada noutras respostas da API ou na assinatura do repositório do pacote. NuGet.org trata os nomes de utilizador dos proprietários de forma insensível ao caso, mas nem todas as fontes de pacotes podem ter essa flexibilidade.

Por exemplo, se a implementação do cliente precisar de mostrar um link para a página de dados do proprietário para o proprietário Microsoft, produzirá o seguinte URL e fornecerá ao utilizador:

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