Licenses API · Gitlab 中文文档

# Licenses API > 原文：[https://docs.gitlab.com/ee/api/templates/licenses.html](https://docs.gitlab.com/ee/api/templates/licenses.html) * [List license templates](#list-license-templates) * [Single license template](#single-license-template) # Licenses API[](#licenses-api "Permalink") 在 GitLab 中，有一个 API 端点可用于处理各种开源许可证模板. 有关各种许可条款的更多信息，请访问[此站点](https://choosealicense.com/)或在线提供的许多其他资源. ## List license templates[](#list-license-templates "Permalink") 获取所有许可证模板. ``` GET /templates/licenses ``` | Attribute | Type | Required | Description | | --- | --- | --- | --- | | `popular` | boolean | no | 如果通过，则仅返回常用许可证 | ``` curl https://gitlab.example.com/api/v4/templates/licenses?popular=1 ``` 响应示例： ``` [ { "key": "apache-2.0", "name": "Apache License 2.0", "nickname": null, "featured": true, "html_url": "http://choosealicense.com/licenses/apache-2.0/", "source_url": "http://www.apache.org/licenses/LICENSE-2.0.html", "description": "A permissive license that also provides an express grant of patent rights from contributors to users.", "conditions": [ "include-copyright", "document-changes" ], "permissions": [ "commercial-use", "modifications", "distribution", "patent-use", "private-use" ], "limitations": [ "trademark-use", "no-liability" ], "content": " Apache License\n Version 2.0, January 2004\n [...]" }, { "key": "gpl-3.0", "name": "GNU General Public License v3.0", "nickname": "GNU GPLv3", "featured": true, "html_url": "http://choosealicense.com/licenses/gpl-3.0/", "source_url": "http://www.gnu.org/licenses/gpl-3.0.txt", "description": "The GNU GPL is the most widely used free software license and has a strong copyleft requirement. When distributing derived works, the source code of the work must be made available under the same license.", "conditions": [ "include-copyright", "document-changes", "disclose-source", "same-license" ], "permissions": [ "commercial-use", "modifications", "distribution", "patent-use", "private-use" ], "limitations": [ "no-liability" ], "content": " GNU GENERAL PUBLIC LICENSE\n Version 3, 29 June 2007\n [...]" }, { "key": "mit", "name": "MIT License", "nickname": null, "featured": true, "html_url": "http://choosealicense.com/licenses/mit/", "source_url": "http://opensource.org/licenses/MIT", "description": "A permissive license that is short and to the point. It lets people do anything with your code with proper attribution and without warranty.", "conditions": [ "include-copyright" ], "permissions": [ "commercial-use", "modifications", "distribution", "private-use" ], "limitations": [ "no-liability" ], "content": "The MIT License (MIT)\n\nCopyright (c) [year] [fullname]\n [...]" } ] ``` ## Single license template[](#single-license-template "Permalink") 获取单个许可证模板. 您可以传递参数来替换许可证占位符. ``` GET /templates/licenses/:key ``` | Attribute | Type | Required | Description | | --- | --- | --- | --- | | `key` | string | yes | 许可证模板的密钥 | | `project` | string | no | 受版权保护的项目名称 | | `fullname` | string | no | 著作权人的全名 | > **注意：**如果省略`fullname`参数但对请求进行身份验证，则将使用经过身份验证的用户名来替换版权所有者占位符. ``` curl --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/templates/licenses/mit?project=My+Cool+Project ``` 响应示例： ``` { "key": "mit", "name": "MIT License", "nickname": null, "featured": true, "html_url": "http://choosealicense.com/licenses/mit/", "source_url": "http://opensource.org/licenses/MIT", "description": "A permissive license that is short and to the point. It lets people do anything with your code with proper attribution and without warranty.", "conditions": [ "include-copyright" ], "permissions": [ "commercial-use", "modifications", "distribution", "private-use" ], "limitations": [ "no-liability" ], "content": "The MIT License (MIT)\n\nCopyright (c) 2016 John Doe\n [...]" } ```