グループWiki API

プラン: Premium、Ultimate
提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated

このAPIを使用して、グループWikiを管理します。プロジェクトWiki用のAPIも利用できます。

Wikiページのコメントはnotesと呼ばれます。それらと対話するには、ノートAPIを使用します。

Wikiページをリスト表示する

指定されたグループのすべてのWikiページをリスト表示します。

GET /groups/:id/wikis

属性	型	必須	説明
`id`	整数または文字列	はい	グループのIDまたはURLエンコードされたパス。
`with_content`	ブール値	いいえ	ページのコンテンツを含めます。

curl \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/groups/1/wikis?with_content=1"

レスポンス例:

[
  {
    "content" : "Here is an instruction how to deploy this project.",
    "format" : "markdown",
    "slug" : "deploy",
    "title" : "deploy",
    "encoding": "UTF-8"
  },
  {
    "content" : "Our development process is described here.",
    "format" : "markdown",
    "slug" : "development",
    "title" : "development",
    "encoding": "UTF-8"
  },{
    "content" : "*  [Deploy](deploy)\n*  [Development](development)",
    "format" : "markdown",
    "slug" : "home",
    "title" : "home",
    "encoding": "UTF-8"
  }
]

Wikiページを取得する

指定されたグループのWikiページを取得します。

GET /groups/:id/wikis/:slug

属性	型	必須	説明
`id`	整数または文字列	はい	グループのIDまたはURLエンコードされたパス。
`slug`	文字列	はい	WikiページのURLエンコードされたslug（一意の文字列）。例: `dir%2Fpage_name`。
`render_html`	ブール値	いいえ	WikiページのレンダリングされたHTMLを返します。
`version`	文字列	いいえ	WikiページのバージョンSHA。

curl \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/groups/1/wikis/home"

レスポンス例:

{
  "content" : "home page",
  "format" : "markdown",
  "slug" : "home",
  "title" : "home",
  "encoding": "UTF-8"
}

Wikiページを作成する

指定されたタイトル、slug、およびコンテンツを持つ特定のプロジェクトのWikiページを作成します。

POST /projects/:id/wikis

属性	型	必須	説明
`id`	整数または文字列	はい	グループのIDまたはURLエンコードされたパス。
`content`	文字列	はい	Wikiページのコンテンツ。
`title`	文字列	はい	Wikiページのタイトル。
`format`	文字列	いいえ	Wikiページのフォーマット。利用可能なフォーマットは、`markdown`（デフォルト）、`rdoc`、`asciidoc`、および`org`です。

curl --request POST \
     --data "format=rdoc&title=Hello&content=Hello world" \
     --header "PRIVATE-TOKEN: <your_access_token>" \
     --url "https://gitlab.example.com/api/v4/groups/1/wikis"

レスポンス例:

{
  "content" : "Hello world",
  "format" : "markdown",
  "slug" : "Hello",
  "title" : "Hello",
  "encoding": "UTF-8"
}

Wikiページを更新する

Wikiページを更新します。Wikiページを更新するには、少なくとも1つのパラメータが必要です。

PUT /groups/:id/wikis/:slug

属性	型	必須	説明
`id`	整数または文字列	はい	グループのIDまたはURLエンコードされたパス。
`content`	文字列	`title`が指定されていない場合は必須	Wikiページのコンテンツ。
`title`	文字列	`content`が指定されていない場合は必須	Wikiページのタイトル。
`format`	文字列	いいえ	Wikiページのフォーマット。利用可能なフォーマットは、`markdown`（デフォルト）、`rdoc`、`asciidoc`、および`org`です。
`slug`	文字列	はい	WikiページのURLエンコードされたslug（一意の文字列）。例: `dir%2Fpage_name`。

curl --request PUT \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/groups/1/wikis/foo" \
  --data "format=rdoc" \
  --data "title=Docs" \
  --data "content=documentation"

レスポンス例:

{
  "content" : "documentation",
  "format" : "markdown",
  "slug" : "Docs",
  "title" : "Docs",
  "encoding": "UTF-8"
}

Wikiページを削除する

指定されたslugを持つ特定のプロジェクトからWikiページを削除します。

DELETE /groups/:id/wikis/:slug

属性	型	必須	説明
`id`	整数または文字列	はい	グループのIDまたはURLエンコードされたパス。
`slug`	文字列	はい	WikiページのURLエンコードされたslug（一意の文字列）。例: `dir%2Fpage_name`。

curl --request DELETE \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/groups/1/wikis/foo"

成功した場合、空の本文を持つ204 No Content HTTPレスポンスが期待されます。

Wikiリポジトリに添付ファイルをアップロードする

特定のプロジェクトのWikiのリポジトリ内の添付ファイルフォルダーにファイルをアップロードします。添付ファイルフォルダーはuploadsフォルダーです。

POST /groups/:id/wikis/attachments

属性	型	必須	説明
`id`	整数または文字列	はい	グループのIDまたはURLエンコードされたパス。
`file`	文字列	はい	アップロードする添付ファイル。
`branch`	文字列	いいえ	ブランチの名前Wikiリポジトリのデフォルトブランチにデフォルト設定されます。

ファイルシステムからファイルをアップロードするには、--form引数を使用します。これにより、cURLはヘッダーContent-Type: multipart/form-dataを使用してデータを送信します。file=パラメータは、ファイルシステムのファイルを指しており、先頭に@を付ける必要があります。例:

curl --request POST \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/groups/1/wikis/attachments" \
  --form "file=@dk.png"

レスポンス例:

{
  "file_name" : "dk.png",
  "file_path" : "uploads/6a061c4cf9f1c28cb22c384b4b8d4e3c/dk.png",
  "branch" : "main",
  "link" : {
    "url" : "uploads/6a061c4cf9f1c28cb22c384b4b8d4e3c/dk.png",
    "markdown" : "![dk](uploads/6a061c4cf9f1c28cb22c384b4b8d4e3c/dk.png)"
  }
}