Git 标签的 REST API 端点

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

签名验证对象

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

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

这些是verification对象中reason的可能值

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

签名验证对象

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

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

这些是verification对象中reason的可能值

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