260806_03_ENH: mutipart 한글 꺠짐 개선
This commit is contained in:
16
README.md
16
README.md
@@ -186,15 +186,12 @@ ExternalApiResponse res = client.postMultipart(url, headers, parts);
|
||||
|
||||
multipart 요청에서는 전달한 headers의 `Content-Type` 값을 무시하고, 필요한 boundary를 포함한
|
||||
`Content-Type: multipart/form-data; boundary=...` 값을 자동 생성합니다.
|
||||
boundary와 multipart 파트 헤더는 US-ASCII로 생성하고, 텍스트 필드 내용은
|
||||
UTF-8, 파일 내용은 원본 `byte[]`로 전송합니다. ASCII 파일명은 기존 `filename`을
|
||||
그대로 사용합니다. non-ASCII 파일명은 서버 호환성을 위해 충돌하지 않는 ASCII
|
||||
fallback을 `filename`에 넣고, UTF-8 퍼센트 인코딩한 원본 파일명을 `filename*`에
|
||||
함께 전송합니다. 공백은 `+`가 아닌 `%20`으로 인코딩됩니다.
|
||||
multipart 파트 헤더와 텍스트 필드는 UTF-8로 인코딩하고, 파일 내용은 원본
|
||||
`byte[]`로 전송합니다. ASCII와 non-ASCII 파일명 모두 원본 값을 quoted `filename`에
|
||||
UTF-8 바이트로 전송하며, ASCII fallback이나 `filename*`는 추가하지 않습니다.
|
||||
|
||||
```http
|
||||
Content-Disposition: form-data; name="file"; filename="attachment.txt";
|
||||
filename*=UTF-8''%ED%95%9C%EA%B8%80-%ED%8C%8C%EC%9D%BC.txt
|
||||
Content-Disposition: form-data; name="file"; filename="한글-파일.txt"
|
||||
```
|
||||
|
||||
지원 메서드:
|
||||
@@ -773,5 +770,8 @@ Endpoint:
|
||||
|
||||
## 변경 이력
|
||||
|
||||
- 2026-08-06: non-ASCII multipart 파일명을 ASCII `filename` fallback과 UTF-8 `filename*`로 함께 전송하도록 개선했습니다.
|
||||
- 2026-08-06: `beta.1.6.3`에서 non-ASCII multipart 파일명을 ASCII fallback/
|
||||
`filename*` 없이 원본 `filename`의 UTF-8 바이트로 전송하도록 복원했습니다.
|
||||
- 2026-08-06: `beta.1.6.2`에서 non-ASCII multipart 파일명에 ASCII `filename`
|
||||
fallback과 UTF-8 `filename*`를 추가했습니다.
|
||||
- 2026-08-04: `kri.auth.apikey.allowed-paths`와 `kri.auth.apikey.excluded-paths`를 추가했습니다. 미설정·`null`·빈 목록은 기존 전역 API Key 인증 동작을 유지하며, 제외 패턴은 허용 패턴보다 우선합니다.
|
||||
|
||||
Reference in New Issue
Block a user