{"openapi":"3.0.3","info":{"title":"APICK 스팸/광고/범죄 전화번호 조회","version":"1.0.0","description":"스팸/광고/범죄에 사용된 전화번호인지 조회합니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/check_spam_number":{"post":{"summary":"스팸/광고/범죄 전화번호 조회","description":"스팸/광고/범죄에 사용된 전화번호인지 조회합니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"number":{"type":"string","description":"조회한 번호입니다. 신고 이력이 있을 때만 들어 있습니다."},"spam":{"type":"string","description":"신고된 유형입니다. 신고 이력이 없으면 빈 문자열입니다. 주요 값: SMS 피싱, 보이스피싱, 불법대출 권유, 투자 권유, 사행성/도박 권유, 판매 권유, 가입 권유, 보험 권유, 여론조사, 스팸, 기타"},"spam_count":{"type":"string","description":"신고 건수입니다. 10건 이하는 숫자 그대로(\"0\"~\"10\"), 그보다 많으면 구간 하한에 +를 붙입니다: \"10+\"(11~20건), \"20+\", \"30+\", \"50+\", \"100+\", \"200+\", \"300+\", \"500+\", \"1000+\". 숫자로 비교하려면 +를 떼고 쓰세요."},"registed_date":{"type":"string","description":"가장 최근 신고일(YYYY-MM-DD)입니다. 신고 이력이 없으면 null입니다.","nullable":true},"cyber_crime":{"type":"string","description":"사이버 사기 피해 신고 이력 안내 문구입니다. 예: \"최근 3개월 내 3건 이상 접수된 민원이 없습니다.\" 확인하지 못했으면 <미확인>입니다."},"success":{"type":"integer","description":"처리 상태입니다. 1이면 조회가 끝난 정상 응답(요금 차감), 0이면 실패 응답(차감 없음)입니다."},"error":{"type":"string","description":"실패 사유 문구입니다. 정상 응답에는 없으며, 값이 있으면 아래 오류 응답 표에서 원인과 조치를 확인하세요."}},"description":"조회 결과 묶음입니다. 실패하면 error 문구가 함께 들어 있습니다."},"api":{"type":"object","properties":{"success":{"type":"boolean","description":"요청을 정상적으로 받아 처리했는지 여부입니다. 신고 여부는 data.spam·data.spam_count로 확인하세요."},"cost":{"type":"integer","description":"이번 호출에서 차감된 포인트입니다. data.error가 있는 실패 응답은 0입니다."},"ms":{"type":"integer","description":"요청을 받아 응답을 만들기까지 걸린 시간(밀리초)입니다. 네트워크 왕복 시간은 포함되지 않습니다."},"pl_id":{"type":"integer","description":"포인트 차감 기록 번호입니다. 차감이 있었던 호출에만 값이 있으며 과금 문의 때 사용합니다."}},"description":"호출 공통 정보입니다. 처리 여부·차감 포인트·처리 시간·차감 기록 번호가 들어 있습니다."}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"number":{"type":"string","description":"조회할 전화번호입니다. 하이픈 없이 숫자만 입력하며, 예: 01012341234. 국가 코드가 필요하면 국제 표기(+82)를 사용하세요. (string)","example":"01012345678"}},"required":["number"]}}}}}}},"x-code-tables":[{"title":"오류 응답","columns":["HTTP","data.error","원인·조치"],"rows":[["400","입력 항목이 잘못됐습니다.","number가 빈 값입니다."],["424","검색에 실패했습니다.","신고 이력을 조회하지 못했습니다. 잠시 후 다시 요청하세요."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}