グループWiki API

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

グループウィキのAPIは、APIv4でのみ利用可能です。プロジェクトWiki用の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`	文字列	はい	`dir%2Fpage_name`のようなWikiページのURLエンコードされたslug（一意の文字列）です。
`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ページを作成する

指定されたリポジトリの新しいWikiページを、指定されたタイトル、slug、およびコンテンツで作成します。

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`	文字列	はい	`dir%2Fpage_name`のようなWikiページのURLエンコードされたslug（一意の文字列）です。

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)"
  }
}

Wikiページへのコメント

Wikiのコメントはnotesと呼ばれます。Notes APIを使用して、それらを操作できます。