IMINE Inbound API

IMINE Inbound API

imineskin.com 문의하기 폼으로 접수되는 인바운드 요청을 수신·처리하는 API입니다. An API that receives and processes inbound submissions from the imineskin.com contact form.

기본 URLBase URL

https://api.imine.afkstudio.co

인증Authentication

모든 요청에는 Authorization 헤더에 Bearer 토큰이 필요합니다. API 키는 별도의 보안 링크로 전달되며, 외부에 노출되지 않도록 주의해 주세요. All requests require a bearer token in the Authorization header. The API key is delivered separately via a secure link — keep it secret and never expose it in client-side code.

Authorization: Bearer <API_KEY>
401 Unauthorized — 키가 없거나 올바르지 않으면 반환됩니다. 401 Unauthorized is returned when the key is missing or invalid.

인바운드 전송Send inbound

POST /inbound

인바운드 요청 1건을 multipart/form-data 형식으로 전송합니다. 웹사이트 폼이 이미 보내는 필드와 동일하므로, 페이로드를 별도로 변경하실 필요는 없습니다. Submit a single inbound submission as multipart/form-data — the same fields the website form already sends, so no payload changes are required on your side.

요청 필드Request fields

필드Field 타입Type 필수 여부Required? 설명Description
boardId string 선택optional GetSmart 문의 보드 ID. 그대로 처리됩니다.GetSmart inquiry board id. Processed as-is.
inquiryCountryCode string 선택optional 국가 구분.Country. 1016001 = 국내, 1016002 = 해외
boardCategoryId string 선택optional 문의 유형.Inquiry type. 3 제품문의 · 4 기술지원 · 5 파트너십 · 6 채용문의 · 7 기타문의
name string 선택optional 문의자 이름.Inquirer name.
companyName string 선택optional 회사명 (비어 있을 수 있음).Company name (may be empty).
phone string 선택optional 연락처.Contact number.
email string 선택optional 이메일 주소.Email address.
title string 선택optional 제목.Subject.
content string 선택optional 문의 본문. HTML 사용 가능.Message body. HTML is allowed.
files file 선택optional 첨부파일. 0개 이상, 각 10MB 이하. 빈 파일은 무시됩니다.Attachment(s). Zero or more, ≤ 10 MB each. Empty parts are ignored.

응답Responses

성공 시 200과 함께 아래 본문이 반환됩니다. 정상 접수된 모든 요청은 동일한 응답을 받으므로, 2xx 응답은 모두 성공으로 간주하고 재시도하지 마세요. On success you receive 200 with the body below. Every accepted submission gets the same response, so treat any 2xx as success and do not retry.

{
  "status": "received"
}
200정상 접수되었습니다.Received successfully.
400잘못된 multipart 요청 본문.Malformed multipart body.
401API 키 누락 또는 오류.Missing or invalid API key.
500처리 실패. 재시도 가능합니다.Could not process it; safe to retry.

예시Example

<API_KEY>를 전달받은 키로 교체하세요. Replace <API_KEY> with the key you were given.

curl -X POST 'https://api.imine.afkstudio.co/inbound' \
  -H 'Authorization: Bearer <API_KEY>' \
  --form-string 'boardId=12345' \
  --form-string 'inquiryCountryCode=1016001' \
  --form-string 'boardCategoryId=3' \
  --form-string 'name=홍길동' \
  --form-string 'companyName=테스트' \
  --form-string 'phone=010-1234-5678' \
  --form-string 'email=hong@example.com' \
  --form-string 'title=세라마이드 크림 개발 문의' \
  --form-string 'content=<p>안녕하세요, 문의드립니다.</p>'