> For the complete documentation index, see [llms.txt](https://docs.dfinery.ai/api-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dfinery.ai/api-guide/api/import-api/response.md).

# 상세 응답

DFINERY Import API는 HTTP Status Code가 아닌 Response Body의 status와 code를 통해 요청의 성공과 실패를 판단합니다.\
HTTP 응답 코드는 항상 200 입니다.\
(단, HTTP Status Code 404는 잘못된 URL 경로, 504는 서버 타임아웃 시 내려갈 수 있습니다.)

## 상세 응답 코드 <a href="#response-codes" id="response-codes"></a>

API 호출이 실패한 경우, 상세 응답 코드를 통해 오류에 대해 상세한 정보를 얻을 수 있습니다.

<table><thead><tr><th width="128.125">HTTP Status Code</th><th width="93.3203125">status (Body)</th><th width="92.7109375">code (Body)</th><th width="220.11328125">message (Body)</th><th>설명</th></tr></thead><tbody><tr><td>200</td><td>true</td><td>20000</td><td><code>OK</code></td><td>요청 성공</td></tr><tr><td>200</td><td>false</td><td>40000</td><td><code>BAD_REQUEST</code></td><td>잘못된 요청</td></tr><tr><td>200</td><td>false</td><td>40001</td><td><code>VALIDATION_FAILURE</code></td><td><p>주요 원인:</p><p>- 이벤트 아이템 수가 100개를 초과</p><p>- 이벤트 또는 이벤트 속성이 사전 등록되지 않음</p><p>- 이벤트 속성의 데이터 타입 불일치</p></td></tr><tr><td>200</td><td>false</td><td>40101</td><td><code>INVALID_SERVICE_ID</code></td><td>잘못된 서비스 ID</td></tr><tr><td>200</td><td>false</td><td>40201</td><td><code>INVALID_TOKEN</code></td><td>잘못된 토큰 제공</td></tr><tr><td>200</td><td>false</td><td>40401</td><td><code>TOO_MANY_REQUEST</code></td><td>API 사용 한도 초과</td></tr><tr><td>200</td><td>false</td><td>40402</td><td><code>TOO_MANY_EVENTS</code></td><td>요청 내 이벤트 수 초과</td></tr><tr><td>200</td><td>false</td><td>40403</td><td><code>TOO_MANY_USER_PROFILES</code></td><td>단일 요청 내 유저 프로필 수 초과</td></tr><tr><td>200</td><td>false</td><td>50000</td><td><code>INTERNAL_SERVER_ERROR</code></td><td>서버 내부 에러 발생</td></tr></tbody></table>

## 응답 예시 <a href="#response-example" id="response-example"></a>

### 20000 OK <a href="#ok-20000" id="ok-20000"></a>

<pre class="language-json"><code class="lang-json">200 OK
<strong>{
</strong>  "status": true,
  "code": 20000,
  "message": "OK",
  "data": null 
}
</code></pre>

### 40001 VALIDATION\_FAILURE <a href="#validation-failure-40001" id="validation-failure-40001"></a>

<pre class="language-json"><code class="lang-json">200 OK
<strong>{
</strong>  "status": false,
  "code": 40001,
  "message": "VALIDATION_FAILURE",
  "data": null 
}
</code></pre>

### 50000 INTERNAL\_SERVER\_ERROR <a href="#internal-server-error-50000" id="internal-server-error-50000"></a>

```json
200 OK
{
  "status": false,
  "code": 50000,
  "message": "INTERNAL_SERVER_ERROR",
  "data": null 
}
```