Create a reference - GitHub API

Creates a reference for your repository. You are unable to create new references for empty repositories, even if the commit SHA-1 hash used exists. Empty repositories are repositories without branches.

curl --location --request POST 'https://api.github.com/repos///git/refs' \ --header 'Content-Type: application/json' \ --data-raw '{ "ref": "refs/heads/featureA", "sha": "aa218f56b14c9653891f9e74264a383fa43fefbd" }'

{ "node_id": "string", "object": { "sha": "7638417db6d59f3c431d3e1f261cc637155684cd", "type": "string", "url": "http://example.com" }, "ref": "string", "url": "http://example.com" }

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

owner

string

必需

repo

string

必需

Body 参数application/json

key

string

可选

示例值:

"refs/heads/newbranch"

ref

string

必需

The name of the fully qualified reference (ie: refs/heads/master). If it doesn't start with 'refs' and have at least two slashes, it will be rejected.

sha

string

必需

The SHA1 value for this reference.

示例

返回响应

🟢201Response

application/json

Body

Git references within a repository

node_id

string

必需

object

必需

sha

string

必需

SHA for the reference

>= 40 字符<= 40 字符

示例值:

7638417db6d59f3c431d3e1f261cc637155684cd

type

string

必需

url

string <uri>

必需

ref

string

必需

url

string <uri>

必需

🟠422422