{"meta":{"title":"Pontos de extremidade da API REST para licenças","intro":"Use a API REST para recuperar licenças populares open source e informações sobre um arquivo de licença de um projeto específico.","product":"API REST","breadcrumbs":[{"href":"/pt/rest","title":"API REST"},{"href":"/pt/rest/licenses","title":"Licenças"},{"href":"/pt/rest/licenses/licenses","title":"Licenças"}],"documentType":"article"},"body":"# Pontos de extremidade da API REST para licenças\n\nUse a API REST para recuperar licenças populares open source e informações sobre um arquivo de licença de um projeto específico.\n\n## Sobre licenças\n\nGitHub usa [o open source Ruby Gem Licensee](https://github.com/benbalter/licensee) para tentar identificar a licença de um projeto. O Licensee compara o conteúdo do arquivo `LICENSE` de um projeto (caso exista) com uma pequena lista de licenças conhecidas. Como resultado, a API não leva em conta as licenças das dependências do projeto ou outros meios de documentar a licença de um projeto, como, por exemplo, referências ao nome da licença na documentação.\n\nSe for encontrada a correspondência de uma licença, a chave de licença e o nome retornados estarão em conformidade com a [especificação SPDX](https://spdx.org/).\n\n**Observação:** estas interfaces de API também retornarão as informações de licença de um repositório.\n\n* [Obter um repositório](/pt/rest/repos/repos#get-a-repository)\n* [Listar os repositórios de um usuário](/pt/rest/repos/repos#list-repositories-for-a-user)\n* [Listar os repositórios da organização](/pt/rest/repos/repos#list-organization-repositories)\n* Listar os forks\n* [Listar os repositórios inspecionados por um usuário](/pt/rest/activity/watching#list-repositories-watched-by-a-user)\n* [Listar os repositórios da equipe](/pt/rest/teams/teams#list-team-repositories)\n\n> \\[!WARNING]\n> GitHub é um monte de coisas, mas não é um escritório de advocacia. Dessa forma, a GitHub não fornece consultoria jurídica. Usar a API ou enviar-nos um email sobre a mesma não constitui aconselhamento jurídico, nem cria uma relação advogado e cliente. Em caso de dúvida sobre o que se pode e não se pode fazer com uma licença específica, antes de avançar, você deverá buscar orientação jurídica antes de seguir em frente. Na verdade, você deve sempre consultar o seu próprio advogado antes de tomar decisões que possam ter desdobramentos jurídicos ou que possam afetar seus direitos.\n>\n> GitHub criou estes pontos de extremidade para ajudar os usuários a obter informações sobre licenças e os projetos que as utilizam. Esperamos que ajude. No entanto, tenha em mente que não somos advogados (pelo menos a maioria de nós) e que cometemos erros como qualquer um. Por esse motivo, o GitHub fornece a API numa base \"como se apresenta\" e não faz garantias sobre quaisquer informações ou licenças fornecidas em ou através dela, além de eximir-se da responsabilidade por danos resultantes do uso da API.\n\n> \\[!NOTE]\n> Most endpoints use `Authorization: Bearer <YOUR-TOKEN>` and `Accept: application/vnd.github+json` headers, plus `X-GitHub-Api-Version: 2026-03-10`. Curl examples below omit these standard headers for brevity.\n\n## Get all commonly used licenses\n\n```\nGET /licenses\n```\n\nLists the most commonly used licenses on GitHub. For more information, see \"Licensing a repository .\"\n\n### Parameters\n\n#### Headers\n\n* **`accept`** (string)\n  Setting to `application/vnd.github+json` is recommended.\n\n#### Path and query parameters\n\n* **`featured`** (boolean)\n\n* **`per_page`** (integer)\n  The number of results per page (max 100). For more information, see \"Using pagination in the REST API.\"\n  Default: `30`\n\n* **`page`** (integer)\n  The page number of the results to fetch. For more information, see \"Using pagination in the REST API.\"\n  Default: `1`\n\n### HTTP response status codes\n\n* **200** - OK\n\n* **304** - Not modified\n\n### Code examples\n\n#### Example\n\n**Request:**\n\n```curl\ncurl -L \\\n  -X GET \\\n  https://api.github.com/licenses\n```\n\n**Response schema (Status: 200):**\n\nArray of `License Simple`:\n\n* `key`: required, string\n* `name`: required, string\n* `url`: required, string or null, format: uri\n* `spdx_id`: required, string or null\n* `node_id`: required, string\n* `html_url`: string, format: uri\n\n## Get a license\n\n```\nGET /licenses/{license}\n```\n\nGets information about a specific license. For more information, see \"Licensing a repository .\"\n\n### Parameters\n\n#### Headers\n\n* **`accept`** (string)\n  Setting to `application/vnd.github+json` is recommended.\n\n#### Path and query parameters\n\n* **`license`** (string) (required)\n\n### HTTP response status codes\n\n* **200** - OK\n\n* **304** - Not modified\n\n* **403** - Forbidden\n\n* **404** - Resource not found\n\n### Code examples\n\n#### Example\n\n**Request:**\n\n```curl\ncurl -L \\\n  -X GET \\\n  https://api.github.com/licenses/LICENSE\n```\n\n**Response schema (Status: 200):**\n\n* `key`: required, string\n* `name`: required, string\n* `spdx_id`: required, string or null\n* `url`: required, string or null, format: uri\n* `node_id`: required, string\n* `html_url`: required, string, format: uri\n* `description`: required, string\n* `implementation`: required, string\n* `permissions`: required, array of string\n* `conditions`: required, array of string\n* `limitations`: required, array of string\n* `body`: required, string\n* `featured`: required, boolean\n\n## Get the license for a repository\n\n```\nGET /repos/{owner}/{repo}/license\n```\n\nThis method returns the contents of the repository's license file, if one is detected.\nThis endpoint supports the following custom media types. For more information, see \"Media types.\"\n\napplication/vnd.github.raw+json: Returns the raw contents of the license.\napplication/vnd.github.html+json: Returns the license contents in HTML. Markup languages are rendered to HTML using GitHub's open-source Markup library.\n\n### Parameters\n\n#### Headers\n\n* **`accept`** (string)\n  Setting to `application/vnd.github+json` is recommended.\n\n#### Path and query parameters\n\n* **`owner`** (string) (required)\n  The account owner of the repository. The name is not case sensitive.\n\n* **`repo`** (string) (required)\n  The name of the repository without the .git extension. The name is not case sensitive.\n\n* **`ref`** (string)\n  The Git reference for the results you want to list. The ref for a branch can be formatted either as refs/heads/<branch name> or simply <branch name>. To reference a pull request use refs/pull/<number>/merge.\n\n### HTTP response status codes\n\n* **200** - OK\n\n* **404** - Resource not found\n\n### Code examples\n\n#### Example\n\n**Request:**\n\n```curl\ncurl -L \\\n  -X GET \\\n  https://api.github.com/repos/OWNER/REPO/license\n```\n\n**Response schema (Status: 200):**\n\n* `name`: required, string\n* `path`: required, string\n* `sha`: required, string\n* `size`: required, integer\n* `url`: required, string, format: uri\n* `html_url`: required, string or null, format: uri\n* `git_url`: required, string or null, format: uri\n* `download_url`: required, string or null, format: uri\n* `type`: required, string\n* `content`: required, string\n* `encoding`: required, string\n* `_links`: required, object:\n  * `git`: required, string or null, format: uri\n  * `html`: required, string or null, format: uri\n  * `self`: required, string, format: uri\n* `license`: required, any of:\n  * **null**\n  * **License Simple**\n    * `key`: required, string\n    * `name`: required, string\n    * `url`: required, string or null, format: uri\n    * `spdx_id`: required, string or null\n    * `node_id`: required, string\n    * `html_url`: string, format: uri"}