🔑
공통 (인증/접근) - 모든 API
| 코드 |
메시지 |
설명 |
| 0000 |
각 API 별 성공 메시지 (예: 키워드 등록 성공, 조회 성공) |
요청이 정상 처리된 경우 (성공) |
| 1000 |
잘못된 접근입니다. |
지원하지 않는 요청 방식(Method)으로 호출한 경우 |
| 4000 |
API 접근정보(user_id / api_key)를 확인해주세요. |
user_id 또는 API Key(authorization 헤더)가 누락된 경우 |
| 4001 |
아이디를 확인해주세요. |
존재하지 않는 user_id 인 경우 |
| 4002 |
API 접근정보를 확인해주세요. |
API 사용 권한이 없거나 API Key가 일치하지 않는 경우 |
| 4003 |
API 접근 메뉴코드(api_menu)를 확인해주세요. |
api_menu 값이 누락된 경우 (사용현황 조회는 api_menu 생략 가능) |
| 4004 |
API 접근 IP를 등록해야 됩니다. |
등록되지 않은 IP에서 호출한 경우 (관리자에게 방화벽 오픈 요청) |
| 4009 |
서비스 만료가 되었습니다. |
서비스 사용기간이 만료된 경우 (관리자에게 연장 문의) |
| 4100 |
api_menu 는 4자리 코드로 넘겨주셔야 됩니다. |
api_menu 값이 4자리 형식이 아닌 경우 |
📌
키워드 등록 (createKeyword)
| 코드 |
메시지 |
설명 |
| 3001 |
검색 키워드 및 체크 키워드(URL)를 입력해주세요. |
keyword 또는 keyword2 값이 누락된 경우 |
| 3100 |
키워드는 30자를 초과 할 수 없습니다. |
keyword(30자) 또는 keyword2(20자)의 최대 길이를 초과한 경우 |
| 3101 |
상품URL이 잘못되었습니다. 확인 후 다시 등록해주세요. |
[가격비교] 상품 URL에서 상품번호를 추출할 수 없는 경우 |
| 9001 |
검색어가 존재하지 않습니다. |
등록할 검색어가 비어있는 경우 |
| 9002 |
등록 가능한 슬롯 수 를 초과했습니다. |
회원 등급별 등록 가능 슬롯 수량을 초과한 경우 |
| 9003 |
등록된 정보가 존재합니다. |
동일한 키워드가 이미 등록되어 있는 경우 (중복 등록) |
| 9004 |
등록 간격 제한입니다. N초 후 다시 시도해주세요. |
등록 성공 후 일정 시간이 지나기 전에 재등록을 요청한 경우.
응답의 retry_after(남은 초), next_available(재시도 가능 시각)을 참고하여 재시도해 주세요. |
| 9005 |
월간 총 슬롯수(N)를 초과하였습니다. |
당월 누적 등록 건수가 월간 허용치를 초과한 경우 |
🔍
키워드 조회 / 순위 조회 (getKeywordList / getKeywordListDetail)
| 코드 |
메시지 |
설명 |
| 2000 |
api_no 값을 확인해주세요. |
조회할 고유번호(api_no)가 누락된 경우 |
| 2001 |
데이터가 존재하지 않습니다. |
조회 조건에 해당하는 데이터가 없는 경우 |
🗑️
삭제 요청 (deleteKeyword)
| 코드 |
메시지 |
설명 |
| 9401 |
삭제할 고유번호는 배열 형태로 입력해주세요. |
api_no_arr 값이 배열이 아닌 경우 |
| 9402 |
삭제할 고유번호는 숫자만 입력해주세요. |
api_no_arr 배열에 숫자가 아닌 값이 포함된 경우 |
| 9403 |
삭제 확인 값(confirm)이 올바르지 않습니다. 'Y'를 입력해주세요. |
confirm 값이 'Y'가 아닌 경우 |
| 9404 |
1회 최대 50개까지 요청 하실 수 있습니다. |
한 번에 50개를 초과하여 삭제 요청한 경우 |
| 9405 |
삭제할 키워드가 존재하지 않거나 권한이 없습니다. |
삭제 대상이 없거나 본인이 등록한 키워드가 아닌 경우 |
| 9406 |
삭제할 데이터가 없습니다. |
삭제 처리할 데이터가 존재하지 않는 경우 |
| 9407 |
삭제 수량을 초과하였습니다. |
이번 주(월요일 0시 기준) 삭제 수량이 주간 한도를 초과한 경우 — 웹·API 삭제 합산 (이번에 삭제할 수량이 남은 수량보다 많아도 발생) |
| 9408 |
플레이스 키워드 삭제 실패 |
삭제 대상은 확인됐지만 삭제 처리에 실패한 경우 |
🔄
재검색 요청 (researchKeyword)
| 코드 |
메시지 |
설명 |
| 9101 |
api_no_arr을 배열 형태로 입력해주세요. |
api_no_arr 값이 배열이 아닌 경우 |
| 9102 |
일일 재검색요청 수량을 초과하였습니다. |
api_no_arr에 숫자가 아닌 값이 있거나, 일일 재검색 한도를 초과한 경우 |
| 9104 |
1회 최대 50개까지 요청 하실 수 있습니다. |
한 번에 50개를 초과하여 재검색 요청한 경우 |
📂
그룹 등록 / 조회 (createGroup / getGroupList)
| 코드 |
메시지 |
설명 |
| 9201 |
그룹명은 20자를 초과 할 수 없습니다. |
그룹명이 최대 길이(20자)를 초과한 경우 |
| 9202 |
그룹명은 한글,영문,숫자,특수문자 일부만 사용가능합니다. |
그룹명에 사용할 수 없는 문자가 포함된 경우 |
| 9203 |
그룹명이 존재하지 않습니다. |
등록할 그룹명이 비어있는 경우 |
| 9204 |
그룹 등록수를 초과했습니다. |
그룹 등록 가능 수량을 초과한 경우 |
| 9205 |
그룹 등록수를 초과했습니다. |
회원별 그룹 등록 가능 수량을 초과한 경우 |
| 9206 |
등록된 그룹명이 존재합니다. |
동일한 그룹명이 이미 등록되어 있는 경우 (중복 등록) |
| 2001 |
데이터가 존재하지 않습니다. |
조회 조건에 해당하는 그룹이 없는 경우 |