Licenses API

原文：https://docs.gitlab.com/ee/api/templates/licenses.html

Licenses API

在 GitLab 中，有一个 API 端点可用于处理各种开源许可证模板. 有关各种许可条款的更多信息，请访问此站点或在线提供的许多其他资源.

List license templates

获取所有许可证模板.

  1. GET /templates/licenses
Attribute Type Required Description
popular boolean no 如果通过，则仅返回常用许​​可证 
  1. curl https://gitlab.example.com/api/v4/templates/licenses?popular=1

响应示例：

  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

获取单个许可证模板. 您可以传递参数来替换许可证占位符.

  1. GET /templates/licenses/:key
Attribute Type Required Description
key string yes 许可证模板的密钥
project string no 受版权保护的项目名称
fullname string no 著作权人的全名

注意：如果省略fullname参数但对请求进行身份验证，则将使用经过身份验证的用户名来替换版权所有者占位符.

  1. curl --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/templates/licenses/mit?project=My+Cool+Project

响应示例：

  1. {  "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 [...]"  }