> For the complete documentation index, see [llms.txt](https://a-send.gitbook.io/api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://a-send.gitbook.io/api/common/network-format.md).

# 요청/응답 형식

### **요청** <a href="#request" id="request"></a>

| 항목           | 값                  |
| ------------ | ------------------ |
| Content-Type | `application/json` |
| Accept       | `application/json` |
| 문자 인코딩       | UTF-8              |

요청 본문은 JSON 형식으로 전달합니다.

### **응답** <a href="#response" id="response"></a>

모든 API 응답은 아래 구조를 따릅니다:

```json
{
  "message": "결과 메시지",
  "data": { ... }
}
```

<table><thead><tr><th width="180">필드</th><th width="215">타입</th><th>설명</th></tr></thead><tbody><tr><td><code>message</code></td><td>string</td><td>처리 결과를 설명하는 메시지</td></tr><tr><td><code>data</code></td><td>object | null</td><td>응답 데이터. 데이터가 없는 경우 <code>null</code></td></tr></tbody></table>

#### **HTTP 상태 코드**

<table><thead><tr><th width="180">코드</th><th width="215">의미</th><th>설명</th></tr></thead><tbody><tr><td><code>200</code></td><td>OK</td><td>요청 성공</td></tr><tr><td><code>202</code></td><td>Accepted</td><td>요청이 정상 접수되어 비동기 처리 예약됨</td></tr><tr><td><code>400</code></td><td>Bad Request</td><td>파라미터 오류, 잔액 부족 등 클라이언트 측 문제</td></tr><tr><td><code>401</code></td><td>Unauthorized</td><td>인증 실패 (키, 서명, 타임스탬프 오류 등)</td></tr><tr><td><code>429</code></td><td>Too Many Requests</td><td>Rate Limit 초과</td></tr><tr><td><code>500</code></td><td>Internal Server Error</td><td>서버 내부 오류</td></tr></tbody></table>

<br>