개발자를 위한 DI3 Mail

회사 도메인 메일을
API로 보내고 받아요

API 키 하나로 우리 서비스에서 회사 주소로 메일을 보내고, 받은 메일을 가져오고, 새 메일 소식을 웹훅으로 받아요. 기본 요금제에 포함돼 있어요.

할 수 있는 것

서비스에 필요한 메일 기능,
API 네 가지로 끝나요

발송

회사 주소로 메일 보내기

가입 안내·주문 확인 같은 메일을 회사 도메인 주소로 보내요. 한 번에 최대 50명, 첨부파일과 참조·숨은참조도 돼요.

POST /api/v1/send

개별 발송

받는 사람끼리 주소 안 보이게

여러 명에게 보내도 한 통씩 따로 보내서, 받는 사람끼리 서로의 주소가 보이지 않아요.

individualSend: true

조회

받은 메일 가져오기

메일함·메일 목록·본문·첨부파일을 가져오고, 필요 없는 메일은 지울 수 있어요. 발송 결과도 작업 번호로 확인해요.

GET /api/v1/messages

웹훅

새 메일이 오면 바로 알림

새 메일이 도착하거나 상대가 보낸 메일을 열면, 등록해 둔 주소로 알려 줘요. 메일 설정의 웹훅 메뉴에서 등록해요.

new_mail · read_receipt

시작하는 순서

세 단계면
첫 메일을 보낼 수 있어요

  1. 가입하고 결제하기

    회사를 만들고 결제 카드를 등록해요. API는 결제 중인 회사에서 쓸 수 있어요.

  2. API 키 발급받기

    회사 관리자가 대시보드의 API 키 메뉴에서 발급해요. 키마다 보낼 수 있는 주소를 정해 둘 수 있어요.

  3. 호출하기

    Authorization 헤더에 키를 넣어 호출해요. 접수되면 작업 번호(jobId)를 바로 돌려줘요.

메일 보내기 예시
curl -X POST https://mail.di3.kr/api/v1/send \
  -H "Authorization: Bearer dk3m_발급받은_키" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "noreply@company.co.kr",
    "to": "customer@example.com",
    "subject": "주문이 접수되었어요",
    "text": "주문해 주셔서 감사합니다."
  }'

응답

{
  "success": true,
  "jobId": "1024",
  "status": "queued",
  "message": "발송 요청이 접수되었습니다."
}

알아 두실 점

쓰기 전에 확인해 주세요

  • 결제 중인 회사만결제가 끊기거나 회사가 정지되면 API 키도 함께 막혀요.
  • 회사 주소로만 발송회사에 등록된 메일 계정 주소로만 보낼 수 있어요.
  • 웹과 같은 한도웹에서 보내는 메일과 같은 시간당·일일 한도를 함께 써요. 넘으면 429로 알려 줘요.
  • 키는 관리자만API 키 발급·재발급·삭제는 회사 관리자만 할 수 있어요.

자주 묻는 질문

API 사용료가 따로 있나요?

아니요, 기본 요금제에 포함돼 있어요. 다만 결제 중인 회사에서만 쓸 수 있고, 결제가 끊기면 API 키도 함께 막혀요.

어떤 주소로 메일을 보낼 수 있나요?

회사에 등록된 메일 계정 주소로만 보낼 수 있어요. API 키마다 허용 주소를 정해 두면 그 주소로만 보내고 조회할 수 있어요.

한 번에 몇 명에게 보낼 수 있나요?

요청 한 번에 최대 50명이에요. 발송 한도는 웹에서 보내는 메일과 같은 회사 한도를 함께 쓰고, 넘으면 429 응답으로 알려 줘요.

받은 메일도 API로 가져올 수 있나요?

네. 메일함·메일 목록·본문·첨부파일을 가져올 수 있어요. 새 메일이 도착하면 웹훅으로 바로 받을 수도 있어요.

API 키는 누가 만들 수 있나요?

회사 관리자가 대시보드의 API 키 메뉴에서 만들어요. 일반 구성원은 만들 수 없어요.

우리 서비스 메일도, 회사 주소로 보내 보세요