# 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 [...]" } ```