{"openapi":"3.0.3","info":{"title":"APICK 이메일 유효성 검사","version":"1.0.0","description":"이메일의 유효성 여부를 검사합니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/check_email_valid":{"post":{"summary":"이메일 유효성 검사","description":"이메일의 유효성 여부를 검사합니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"이메일":{"type":"string","description":"검사한 이메일 주소입니다. 앞뒤 공백을 지운 값입니다."},"유효성":{"type":"boolean","description":"메일을 보낼 수 있는 주소인지 종합 판정입니다. 형식이 맞고 도메인상태가 ok일 때만 true입니다. 가입 허용 여부는 이 값으로 먼저 판단하세요."},"제공자":{"type":"string","description":"이 도메인의 메일을 실제로 받아 주는 메일 서비스의 도메인입니다. 회사 도메인이라도 구글·마이크로소프트 메일을 쓰면 google.com 등으로 옵니다. 확인하지 못하면 null입니다.","nullable":true},"도메인":{"type":"string","description":"주소의 @ 뒤 도메인입니다. 예: example.com"},"도메인상태":{"type":"string","description":"도메인의 메일 수신 상태입니다.ok: 메일을 받을 수 있는 도메인invalid: 도메인 이름 형식이 잘못됨no-service: 도메인 소유자가 메일을 받지 않는다고 설정함no-mail: 메일을 받을 서버 설정이 없음(도메인 오타일 가능성 큼)resolv-error: 일시적으로 확인하지 못함(잠시 후 다시 검사)"},"무료이메일여부":{"type":"boolean","description":"gmail.com·naver.com처럼 누구나 무료로 만드는 메일 도메인이면 true입니다. 기업 전용 도메인이면 false입니다."},"일회용이메일여부":{"type":"boolean","description":"짧은 기간만 쓰고 버리는 일회용 메일 도메인이면 true입니다. 가입 남용을 막으려면 true인 주소를 거절하세요."},"개인용이메일여부":{"type":"boolean","description":"개인이 쓰는 주소로 보이면 true입니다. 일회용 도메인이거나 info·admin·support처럼 여러 사람이 함께 쓰는 공용 주소면 false입니다."},"MX-IP":{"type":"string","description":"이 도메인의 메일을 받는 서버의 IP 주소입니다. 확인하지 못하면 null입니다.","nullable":true},"success":{"type":"integer","description":"처리 상태입니다. 1이면 검사가 끝난 정상 응답(요금 차감), 0이면 실패 응답(차감 없음)입니다."},"error":{"type":"string","description":"실패 사유 문구입니다. 정상 응답에는 없으며, 값이 있으면 아래 오류 응답 표에서 원인과 조치를 확인하세요."}},"description":"검사 결과 묶음입니다. 실패하면 아래 필드 대신 error 문구가 들어 있습니다."},"api":{"type":"object","properties":{"success":{"type":"boolean","description":"요청을 정상적으로 받아 처리했는지 여부입니다. 주소가 쓸 만한지는 data.유효성으로 확인하세요."},"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":{"email":{"type":"string","description":"검증할 이메일 주소입니다. @와 도메인을 포함한 전체 주소를 보내며, 형식이 맞지 않으면 조회 전에 거부됩니다. (string)","example":"user@gmail.com"}},"required":["email"]}}}}}}},"x-code-tables":[{"title":"오류 응답","columns":["HTTP","data.error","원인·조치"],"rows":[["400","이메일 형식이 맞지 않습니다.","email이 없거나 @·도메인이 빠진 주소입니다. 검사하지 않으며 요금도 차감되지 않습니다."],["424","이메일 검사에 실패했습니다.","일시적인 실패입니다. 잠시 후 다시 요청하세요."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}