Run2Mail을 기반으로 구축

Developer API Documentation

Learn how to create API keys, authenticate requests, create inboxes, fetch messages, and handle common Run2Mail API responses.

API 키 입증 핵심 엔드포인트 오류 코드

API 키

대시보드에서 개발자 API 키를 생성하세요. 각 키는 전체 내용이 한 번만 표시되며 이후 확인을 위해 보안 해시로 저장됩니다.

로그인한 대시보드에서 키를 생성하세요.
키를 비공개로 유지하고 비밀 관리자에 보관하세요.
장치, 스크립트 또는 팀원이 더 이상 액세스할 필요가 없을 때마다 이전 키를 취소합니다.

입증

보호되는 모든 요청에 대해 Authorization 헤더에 Bearer 토큰을 사용하세요.

Authorization: Bearer YOUR_API_KEY

키가 유효하지 않거나 취소되거나 누락된 경우 API는 인증 오류로 응답합니다.

핵심 엔드포인트

가장 일반적인 작업 흐름은 인증된 사용자를 검사하고 받은 편지함을 만든 다음 해당 받은 편지함에서 메시지를 가져오는 것입니다.

현재 계좌를 확인하세요

curl -X GET "https://run2mail.com/api/v1/me" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

받은 편지함 만들기

curl -X POST "https://run2mail.com/api/v1/emails/create" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "random"
  }'

받은편지함 메시지 가져오기

curl -X GET "https://run2mail.com/api/v1/emails/example@2mail.lol/messages" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

샘플 JSON 응답

{
  "success": true,
  "data": {
    "email": "example@2mail.lol",
    "messages": []
  }
}

비율 제한

Run2Mail은 서비스를 보호하고 API 액세스를 안정적으로 유지하기 위해 계획 기반 요청 제한과 일일 받은 편지함 생성 제한을 적용합니다.

분당 속도 제한은 활성 플랜에 따라 다릅니다.
이메일 생성 제한은 기본 읽기 호출과 별도로 추적됩니다.
관리 분석 대시보드 내부의 가시성을 위해 사용량이 기록됩니다.

오류 코드

401: API 자격 증명이 누락되었거나 유효하지 않습니다.
403: 요청에 대한 액세스가 차단, 제한 또는 허용되지 않습니다.
429: 요청량이 현재 한도를 초과했습니다.
503: 플랫폼에 의해 개발자 API가 일시적으로 비활성화되었습니다.

대시보드 API 스크린샷이 곧 제공될 예정입니다.

이 영역은 API 키 관리자 및 사용량 대시보드의 향후 스크린샷을 위해 예약되어 있습니다.