> For the complete documentation index, see [llms.txt](https://support.iafcertsearch.org/api-developer-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.iafcertsearch.org/api-developer-guide/api-ko/api-integration/requests.md).

# 요청

"# 요청

#### 요청 보내기

**호스트**

Web API v1 요청에 대한 호스트는 항상 `https://api.iafcertsearch.org/api/client/v1`입니다.

{% hint style="info" %}
모든 요청은 HTTPS를 통해 이루어져야 합니다. API는 HTTP를 지원하지 않습니다.
{% endhint %}

**인증 헤더**

[인증](https://github.com/QualityTrade/iaf-docs-api-developer-guide-ko/blob/main/api-integration/broken-reference/README.md)에서 설명한 대로 인증 헤더를 제공해야 합니다.

**HTTP 동사**

* `GET` 리소스나 리소스 그룹 검색
* `POST` 새 리소스 생성
* `PUT` 기존 리소스 업데이트
* `DELETE` 기존 리소스 삭제
* `OPTIONS` 특정 리소스에 대한 허용된 동사 보기

**Accept 헤더**

API는 JSON 응답을 제공합니다. 현재 accept 헤더는 필요하지 않지만, 앞으로 필요할 수도 있습니다. 설정되지 않은 경우 API는 `application/json`을 사용합니다.

```http
GET https://api.iafcertsearch.org/api/client/v1/endpoint HTTP/1.1
Accept: application/json
```

**데이터 배열**

`GET` 요청에서 데이터 배열을 보낼 때, URL에 매개변수를 여러 번 포함시켜야 합니다. 매개변수 이름에는 대괄호가 필요하지 않습니다.

```http
GET https://api.iafcertsearch.org/api/client/v1/endpoint?parameter=data1&parameter=data2 HTTP/1.1
```

#### 요청 형식 지정

**요청 본문**

`POST`나 `PUT`를 통해 리소스에 데이터를 제출할 때, 페이로드를 JSON으로 제출해야 합니다.

```http
POST https://api.iafcertsearch.org/api/client/v1/example/ HTTP/1.1
Content-Type: application/json
```

```json
{
  "name": "새 예제 이름"
}
```

**페이지네이션**

일부 `GET` 리소스는 일괄적으로 정보를 검색할 수 있도록 허용합니다. 해당되는 경우 리소스 설명에 쿼리 매개변수를 제공해 드리겠습니다.

여러 항목을 요청할 때, 요청 `limit`를 기본적으로 `20`으로 설정합니다. 필요할 때 `limit` 매개변수를 사용하여 다른 제한을 지정할 수 있습니다. 우리가 허용하는 `limit` 매개변수의 최대 값은 `100`입니다.

아래는 `limit=100`과 `offset=0` 매개변수에 의해 지정된 첫 번째 100개 레코드를 검색하는 API 요청 예시입니다.

다음 일괄 레코드를 검색하려면 offset 매개변수를 `1` 증가시키면 됩니다.

```http
GET https://api.iafcertsearch.org/api/client/v1/resource?limit=100&offset=0 HTTP/1.1
```

#### 성공적인 요청

| **동사** | **리소스 객체 반환**           |
| ------ | ----------------------- |
| GET    | 단일 리소스 객체나 리소스 객체 배열 반환 |
| PATCH  | 업데이트된 리소스 객체 반환         |
| PUT    | 업데이트된 리소스 객체 반환         |
| DELETE | 콘텐츠가 반환되지 않음            |
| POST   | 새로 생성된 리소스 객체 반환        |