用于 Git 标签的 REST API 端点

请注意，创建标签对象不会创建在 Git 中创建标签的引用。如果您想在 Git 中创建带注释的标签，您必须执行此调用以创建标签对象，然后 创建 refs/tags/[tag] 引用。如果您想创建轻量级标签，您只需要 创建 标签引用 - 此调用将是不必要的。

签名验证对象

响应将包含一个 verification 对象，该对象描述了验证提交签名的结果。verification 对象中包含以下字段

名称	类型	描述
已验证	布尔值	指示 GitHub 是否认为此提交中的签名已验证。
原因	字符串	已验证值的理由。下表列出了可能的值及其含义。
签名	字符串	从提交中提取的签名。
有效载荷	字符串	签名的值。

以下是 verification 对象中 reason 的可能值

值	描述
已过期密钥	生成签名的密钥已过期。
非签名密钥	“签名”标志不在生成签名的 GPG 密钥的用法标志中。
gpgverify 错误	与签名验证服务通信时出现错误。
gpgverify 不可用	签名验证服务当前不可用。
未签名	该对象不包含签名。
unknown_signature_type	在提交中发现了一个非 PGP 签名。
no_user	提交中的 committer 电子邮件地址未与任何用户关联。
unverified_email	提交中的 committer 电子邮件地址与一个用户关联，但该电子邮件地址未在其帐户上验证。
bad_email	提交中的 committer 电子邮件地址未包含在生成签名的 PGP 密钥的身份中。
unknown_key	生成签名的密钥未在任何用户的帐户中注册。
malformed_signature	解析签名时出错。
invalid	无法使用在签名中找到密钥 ID 的密钥对签名进行密码验证。
valid	以上错误均不适用，因此签名被认为已验证。

签名验证对象

响应将包含一个 verification 对象，该对象描述了验证提交签名的结果。verification 对象中包含以下字段

名称	类型	描述
已验证	布尔值	指示 GitHub 是否认为此提交中的签名已验证。
原因	字符串	已验证值的理由。下表列出了可能的值及其含义。
签名	字符串	从提交中提取的签名。
有效载荷	字符串	签名的值。

以下是 verification 对象中 reason 的可能值

值	描述
已过期密钥	生成签名的密钥已过期。
非签名密钥	“签名”标志不在生成签名的 GPG 密钥的用法标志中。
gpgverify 错误	与签名验证服务通信时出现错误。
gpgverify 不可用	签名验证服务当前不可用。
未签名	该对象不包含签名。
unknown_signature_type	在提交中发现了一个非 PGP 签名。
no_user	提交中的 committer 电子邮件地址未与任何用户关联。
unverified_email	提交中的 committer 电子邮件地址与一个用户关联，但该电子邮件地址未在其帐户上验证。
bad_email	提交中的 committer 电子邮件地址未包含在生成签名的 PGP 密钥的身份中。
unknown_key	生成签名的密钥未在任何用户的帐户中注册。
malformed_signature	解析签名时出错。
invalid	无法使用在签名中找到密钥 ID 的密钥对签名进行密码验证。
valid	以上错误均不适用，因此签名被认为已验证。