Cultureland 설정
문화상품권(Cultureland) PIN 발급에 사용할 계정 자격 증명을 등록합니다.
POST
https://pin.apiacc.com/cultureland/settingsCultureland 파트너 계정 정보를 등록하거나 갱신합니다. 자격 증명은 암호화되어 저장됩니다.
파트너 계약이 필요합니다
이 API를 사용하려면 Cultureland와 별도의 API 파트너 계약이 필요합니다. 계약이 완료되지 않은 계정은 403 contract_required 오류를 받습니다.
요청 본문
| 필드 | 타입 | 필수 | 제한 | 예시 |
|---|---|---|---|---|
usernameCultureland 파트너 계정 ID입니다. | string | 필수 | — | "cl_service_id" |
passwordCultureland 파트너 계정 비밀번호입니다. 응답에는 포함되지 않습니다. | string | 필수 | — | "••••••••" |
curl -X POST "https://pin.apiacc.com/cultureland/settings" \
-H "Authorization: Bearer $PIN_API_KEY" \
-H "Content-Type: application/json" \
--max-time 10 \
-d '{
"username": "cl_service_id",
"password": "••••••••"
}'응답
200설정 완료
{
"cultureland": {
"username": "cl_service_id",
"status": "connected",
"verified_at": "2026-08-15T03:30:00Z"
}
}계정 인증에 실패하면 저장되지 않고 오류가 반환됩니다.
주요 오류
| 상태 | error |
|---|---|
| 400 | invalid_credentials_format |
| 401 | cultureland_auth_failed |
| 403 | contract_required |
| 429 | rate_limit_exceeded |