{{< details >}}
- Tier: Free, Premium, Ultimate
- Offering: JihuLab.com, 私有化部署
{{< /details >}}
在极狐GitLab中,有一个 API 端点可用于处理各种开源许可证模板。
具有访客角色的用户无法访问许可证模板。有关详细信息,请参阅项目和群组可见性。
列出许可证模板
获取所有许可证模板。
GET /templates/licenses
属性 | 类型 | 必需 | 描述 |
---|---|---|---|
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 [...]"
}
]
单个许可证模板
获取单个许可证模板。您可以传递参数来替换许可证占位符。
GET /templates/licenses/:key
属性 | 类型 | 必需 | 描述 |
---|---|---|---|
key |
string | yes | 许可证模板的键 |
project |
string | no | 受版权保护的项目名称 |
fullname |
string | no | 版权持有者的全名 |
{{< alert type=”note” >}}
如果您省略了 fullname
参数但验证了您的请求,则认证用户的姓名将替换版权持有者占位符。
{{< /alert >}}
示例请求:
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 [...]"
}