# gitignore 用 REST API エンドポイント

REST API を使用して、ファイルとディレクトリを無視するために使用できる .gitignore テンプレートを取得します。

## gitignore について

API を介して GitHub で新しいリポジトリを作成するとき、[.gitignore テンプレート](/ja/enterprise-server@3.19/get-started/git-basics/ignoring-files)を指定して作成時にリポジトリに適用できます。 REST API を使って、GitHub [.gitignore リポジトリ](https://github.com/github/gitignore)から .gitignore テンプレートを取得できます。

> \[!NOTE]
> Most endpoints use `Authorization: Bearer <YOUR-TOKEN>` and `Accept: application/vnd.github+json` headers, plus `X-GitHub-Api-Version: 2022-11-28`. Curl examples below omit these standard headers for brevity.

## Get all gitignore templates

```
GET /gitignore/templates
```

List all templates available to pass as an option when creating a repository.

### HTTP response status codes

* **200** - OK

* **304** - Not modified

### Code examples

#### Example

**Request:**

```curl
curl -L \
  -X GET \
  http(s)://HOSTNAME/api/v3/gitignore/templates
```

**Response schema (Status: 200):**

Array of string

## Get a gitignore template

```
GET /gitignore/templates/{name}
```

Get the content of a gitignore template.
This endpoint supports the following custom media types. For more information, see "Media types."

application/vnd.github.raw+json: Returns the raw .gitignore contents.

### Parameters

#### Headers

* **`accept`** (string)
  Setting to `application/vnd.github+json` is recommended.

#### Path and query parameters

* **`name`** (string) (required)

### HTTP response status codes

* **200** - OK

* **304** - Not modified

### Code examples

#### Example

**Request:**

```curl
curl -L \
  -X GET \
  http(s)://HOSTNAME/api/v3/gitignore/templates/NAME
```

**Response schema (Status: 200):**

* `name`: required, string
* `source`: required, string