Create or update file contents

Creates a new file or replaces an existing file in a repository.

curl --location --request PUT 'https://api.github.com/repos///contents/' \ --header 'Content-Type: application/json' \ --data-raw '{ "committer": { "email": "octocat@github.com", "name": "Monalisa Octocat" }, "content": "bXkgbmV3IGZpbGUgY29udGVudHM=", "message": "my commit message" }'

{ "commit": { "author": { "date": "string", "email": "string", "name": "string" }, "committer": { "date": "string", "email": "string", "name": "string" }, "html_url": "string", "message": "string", "node_id": "string", "parents": [ { "html_url": "string", "sha": "string", "url": "string" } ], "sha": "string", "tree": { "sha": "string", "url": "string" }, "url": "string", "verification": { "payload": "string", "reason": "string", "signature": "string", "verified": true } }, "content": { "_links": { "git": "string", "html": "string", "self": "string" }, "download_url": "string", "git_url": "string", "html_url": "string", "name": "string", "path": "string", "sha": "string", "size": 0, "type": "string", "url": "string" } }

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Path 参数

owner

string

必需

repo

string

必需

path

string

必需

path parameter

Body 参数application/json

author

object

可选

The author of the file. Default: The committer or the authenticated user if you omit committer.

date

string

可选

示例值:

"2013-01-15T17:13:22+05:00"

string

必需

The email of the author or committer of the commit. You'll receive a 422 status code if email is omitted.

name

string

必需

The name of the author or committer of the commit. You'll receive a 422 status code if name is omitted.

branch

string

可选

The branch name. Default: the repository’s default branch (usually master)

committer

object

可选

The person that committed the file. Default: the authenticated user.

date

string

可选

示例值:

"2013-01-05T13:13:22+05:00"

string

必需

The email of the author or committer of the commit. You'll receive a 422 status code if email is omitted.

name

string

必需

The name of the author or committer of the commit. You'll receive a 422 status code if name is omitted.

content

string

必需

The new file content, using Base64 encoding.

message

string

必需

The commit message.

sha

string

可选

Required if you are updating a file. The blob SHA of the file being replaced.

示例

返回响应

🟢200Response

application/json

Body

File Commit

commit

object

必需

author

object

可选

committer

object

可选

html_url

string

可选

message

string

可选

node_id

string

可选

parents

array [object {3}]

可选

sha

string

可选

tree

object

可选

url

string

可选

verification

object

可选

content

object | null

必需

_links

object

可选

download_url

string

可选

git_url

string

可选

html_url

string

可选

name

string

可选

path

string

可选

sha

string

可选

size

integer

可选

type

string

可选

url

string

可选

🟢201Response

🟠404404

🟠409409

🟠422422