{"openapi":"3.0.3","info":{"title":"APICK 이메일 위험도 일괄 검사","version":"1.0.0","description":"이메일 주소를 한 번에 100건까지 받아 형식·일회용 메일·무료 메일·공용 주소 여부와 위험 등급을 돌려줍니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/email_risk_batch":{"post":{"summary":"이메일 위험도 일괄 검사","description":"이메일 주소를 한 번에 100건까지 받아 형식·일회용 메일·무료 메일·공용 주소 여부와 위험 등급을 돌려줍니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"email":{"type":"string","description":"검사한 주소입니다. 앞뒤 공백을 지운 값입니다."},"valid_syntax":{"type":"boolean","description":"주소 형식이 맞는지 여부입니다."},"domain":{"type":"string","description":"@ 뒤 도메인입니다. 형식이 맞지 않으면 null입니다.","nullable":true},"disposable":{"type":"boolean","description":"짧은 기간만 쓰고 버리는 일회용 메일 도메인이면 true입니다."},"free":{"type":"boolean","description":"누구나 무료로 만드는 메일 도메인이면 true입니다."},"role_account":{"type":"boolean","description":"info·admin·support처럼 여러 사람이 함께 쓰는 공용 주소면 true입니다."},"risk":{"type":"string","description":"위험 등급입니다.high: 형식 오류 또는 일회용 메일medium: 무료 메일 또는 공용 주소low: 그 밖의 주소"}}},"description":"보낸 순서대로 담긴 건별 결과입니다. 주소 하나가 잘못돼도 나머지는 그대로 판정합니다."},"summary":{"type":"object","properties":{"total":{"type":"integer"},"invalid":{"type":"integer"},"disposable":{"type":"integer"},"free":{"type":"integer"},"role_account":{"type":"integer"},"high":{"type":"integer"},"medium":{"type":"integer"},"low":{"type":"integer"}},"description":"건수 요약입니다. total, invalid, disposable, free, role_account, high, medium, low가 들어 있습니다."},"success":{"type":"integer"},"error":{"type":"string","description":"실패 사유 문구입니다. 정상 응답에는 없습니다."}},"description":"검사 결과 묶음입니다. 실패하면 아래 필드 대신 error 문구가 들어 있습니다."},"api":{"type":"object","properties":{"success":{"type":"boolean"},"cost":{"type":"integer","description":"이번 호출에서 차감된 포인트입니다. data.error가 있는 실패 응답은 0입니다."},"ms":{"type":"integer","description":"요청을 받아 응답을 만들기까지 걸린 시간(밀리초)입니다."},"pl_id":{"type":"integer"}},"description":"호출 공통 정보입니다. 처리 여부·차감 포인트·처리 시간·차감 기록 번호가 들어 있습니다."}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"emails":{"type":"string","description":"이메일 주소를 줄바꿈 또는 쉼표로 구분해 최대 100건 (예: a@example.com, b@example.com) (string)","example":"user@gmail.com, temp@mailinator.com, admin@example.com"}},"required":["emails"]}}}}}}},"x-code-tables":[{"title":"오류 응답","columns":["HTTP","data.error","원인·조치"],"rows":[["400","이메일 목록이 필요합니다.","emails가 비어 있습니다. 주소를 하나 이상 보내세요."],["400","이메일은 한 번에 100건까지 검사할 수 있습니다.","100건을 넘겨 보냈습니다. 나눠서 호출하세요."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}