{"openapi":"3.0.3","info":{"title":"APICK 성명/주민등록번호 실명확인","version":"1.0.0","description":"성명과 주민등록번호를 입력받아 실제 존재여부를 확인합니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/name_rrn_auth":{"post":{"summary":"성명/주민등록번호 실명확인","description":"성명과 주민등록번호를 입력받아 실제 존재여부를 확인합니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"result":{"type":"integer","description":"실명 확인 결과입니다. 1일 때만 실명 확인 통과로 처리하세요.1: 이름과 주민등록번호가 일치0: 일치하지 않음-1: 확인하지 못함(잠시 후 다시 요청, 요금 차감 없음)"},"msg":{"type":"string","description":"결과 안내 문구입니다. result에 따라 다음 중 하나입니다.1: \"실명과 주민등록번호가 일치합니다.\"0: \"실명과 주민등록번호가 일치하지 않습니다.\"-1: \"실명확인에 실패했습니다.\""},"success":{"type":"integer","description":"처리 상태입니다. 1이면 결과가 확정된 정상 응답(요금 차감), 0이면 확인 실패나 입력 오류(차감 없음)입니다."},"error":{"type":"string","description":"입력 오류 문구입니다. 정상 응답에는 없으며, 어느 항목이 틀렸는지 대괄호 안에 적혀 있습니다. 예: \"[rrn2] 입력 항목이 잘못됐습니다.\""}},"description":"실명 확인 결과 묶음입니다. 입력 오류면 result 대신 error 문구가 들어 있습니다."},"api":{"type":"object","properties":{"success":{"type":"boolean","description":"요청을 정상적으로 받아 처리했는지 여부입니다. true여도 실명 일치 여부는 data.result로 따로 확인해야 합니다."},"cost":{"type":"integer","description":"이번 호출에서 차감된 포인트입니다. result가 -1이거나 입력 오류인 응답은 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":{"name":{"type":"string","description":"인증 대상자의 한글 성명입니다. 여권·외국인등록증의 영문 이름과 다를 수 있으므로 한글 표기를 그대로 입력하세요. (string)","example":"홍길동"},"rrn1":{"type":"string","description":"주민등록번호 앞 6자리(생년월일)입니다. 예: 900101. 뒤 7자리와 함께 보내며, 하이픈 없이 숫자만 입력합니다. (string)","example":"900101"},"rrn2":{"type":"string","description":"주민등록번호 뒤 7자리입니다. 성별·지역 코드가 포함되며, 하이픈 없이 숫자만 입력합니다. (string)","example":"1******"}},"required":["name","rrn1","rrn2"]}}}}}}},"x-code-tables":[{"title":"오류 응답","columns":["HTTP","data.error","원인·조치"],"rows":[["400","[name] 입력 항목이 잘못됐습니다.","name이 비어 있습니다."],["400","[rrn1] 입력 항목이 잘못됐습니다.","rrn1이 6자가 아닙니다."],["400","[rrn2] 입력 항목이 잘못됐습니다.","rrn2가 7자가 아닙니다. 하이픈이나 공백이 섞였는지 확인하세요."],["200","(없음) data.result -1","일시적으로 확인하지 못했습니다. 잠시 후 같은 값으로 다시 요청하세요. 요금은 차감되지 않습니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}