이메일 전달 API

라이브러리

현재 API 래퍼는 아직 출시하지 않았지만 가까운 시일 내에 배포 할 계획입니다. 에 이메일 보내기api@forwardemail.net 특정 프로그래밍 언어의 API 래퍼가 릴리스 될 때 알림을 받으려면 한편, 권장 HTTP 요청 라이브러리를 애플리케이션에서 사용하거나 간단히곱슬 곱슬하다 아래 예와 같이.

언어	도서관
루비	패러데이
파이썬	요청
자바	OkHttp
PHP	목구멍
자바 스크립트	슈퍼 에이전트
Node.js	슈퍼 에이전트
가다	순 / http
.그물	RestSharp

기본 URI

현재 HTTP 기본 URI 경로는 다음과 같습니다.https://api.forwardemail.net. 의 레거시 HTTP 기본 URI 경로https://forwardemail.net:4000 2021 년 1 월 1 일부터 지원 중단 될 예정입니다.

입증

모든 엔드 포인트에는무료 API 키 🎉 요청의 "사용자 이름"값으로 설정기본 인증 헤더. 걱정하지 마십시오. 이것이 무엇인지 확실하지 않은 경우 아래에 예제가 제공됩니다.

오류

오류가 발생하면 API 요청의 응답 본문에 자세한 오류 메시지가 포함됩니다. API를 작성하고 문서화 한 경험이 10 년 이상인 것 외에도문 우리가 우리를 만들 때 아름다운 API 문서 😄.

암호	이름
200	확인
400	나쁜 요청
401	무단
403	금지
404	찾을 수 없음
429	너무 많은 요청
500	인터넷 서버 오류
501	구현되지 않음
502	나쁜 게이트웨이
503	사용할 수없는 서비스
504	게이트웨이 시간 초과

Tip: If you receive a 5xx status code (which should not happen), then please contact us at api@forwardemail.net and we will help you to resolve your issue immediately.

현지화

우리의 서비스는 25 개 이상의 언어로 번역됩니다. 모든 API 응답 메시지는 API 요청을하는 사용자의 마지막 로케일로 변환됩니다. 당신은 사용자 정의를 전달하여 이것을 무시할 수 있습니다Accept-Language 헤더. 이 페이지 하단의 언어 드롭 다운 메뉴를 사용하여 자유롭게 사용해보십시오.

쪽수 매기기

페이지 매김이 가능할 때 알림을 받으려면 이메일을 보내주십시오api@forwardemail.net.

계정

계정 만들기

POST /v1/account

바디 파라미터	필수	유형	기술
`email`	예	문자열 (이메일)	이메일 주소
`password`	예	끈	암호

요청 예 :

curl -X POST https://api.forwardemail.net/v1/account \
  -u API_TOKEN: \
  -d "email=user%40gmail.com"

Example Response:

{
  "statusCode": 400,
  "error": "Bad Request",
  "message": "Password was invalid."
}

계정 검색

GET /v1/account

요청 예 :

curl -X GET https://api.forwardemail.net/v1/account \
  -u API_TOKEN:

Example Response:

{
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "Invalid API token."
}

계정 업데이트

PUT /v1/account

바디 파라미터	필수	유형	기술
`email`	아니	문자열 (이메일)	이메일 주소
`given_name`	아니	끈	이름
`family_name`	아니	끈	성
`avatar_url`	아니	문자열 (URL)	아바타 이미지에 연결

요청 예 :

curl -X PUT https://api.forwardemail.net/v1/account \
  -u API_TOKEN: \
  -d "email=user%40gmail.com"

Example Response:

{
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "Invalid API token."
}

도메인

Tip: Domain endpoints with a domain's name /v1/domains/:domain_name as their path are interchangable with a domain's ID :domain_id. This means you can refer to the domain by either its name or id value.

도메인 목록

GET /v1/domains

쿼리 문자열 파라미터	필수	유형	기술
`name`	아니	문자열 (RegExp 지원)	이름으로 도메인 검색
`alias`	아니	문자열 (RegExp 지원)	별칭 이름으로 도메인 검색
`recipient`	아니	문자열 (RegExp 지원)	수신자별로 도메인 검색

요청 예 :

curl -X GET https://api.forwardemail.net/v1/domains \
  -u API_TOKEN:

Example Response:

{
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "Invalid API token."
}

도메인 만들기

POST /v1/domains

바디 파라미터	필수	유형	기술
`domain`	예	문자열 (FQDN 또는 IP)	정규화 된 도메인 이름 ( "FQDN") 또는 IP 주소
`plan`	아니	문자열 (열거 가능)	계획 유형`"free"`,`"enhanced_protection"`또는`"team"`기본값은`"free"`)

요청 예 :

curl -X POST https://api.forwardemail.net/v1/domains \
  -u API_TOKEN: \
  -d domain=example.com \
  -d plan=free

Example Response:

{
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "Invalid API token."
}

도메인 검색

GET /v1/domains/example.com

요청 예 :

curl -X GET https://api.forwardemail.net/v1/domains/example.com \
  -u API_TOKEN:

Example Response:

{
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "Invalid API token."
}

도메인 레코드 확인

GET /v1/domains/example.com/verify-records

요청 예 :

curl -X GET https://api.forwardemail.net/v1/domains/example.com/verify-records \
  -u API_TOKEN:

Example Response:

{
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "Invalid API token."
}

도메인 업데이트

PUT /v1/domains/example.com

바디 파라미터	필수	유형	기술
`smtp_port`	아니	문자열 또는 숫자	SMTP 전달을 위해 구성 할 사용자 정의 포트 (기본값은`"25"`)

요청 예 :

curl -X PUT https://api.forwardemail.net/v1/domains/example.com \
  -u API_TOKEN:

Example Response:

{
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "Invalid API token."
}

도메인 삭제

DELETE /v1/domains/:domain_name

요청 예 :

curl -X DELETE https://api.forwardemail.net/v1/domains/:domain_name \
  -u API_TOKEN:

초대

도메인 초대 수락

GET /v1/domains/:domain_name/invites

요청 예 :

curl -X GET https://api.forwardemail.net/v1/domains/:domain_name/invites \
  -u API_TOKEN:

도메인 초대 만들기

POST /v1/domains/example.com/invites

바디 파라미터	필수	유형	기술
`email`	예	문자열 (이메일)	도메인 회원 목록에 초대 할 이메일 주소
`group`	예	문자열 (열거 가능)	사용자를 도메인 멤버십에 추가 할 그룹 (`"admin"` 또는`"user"`)

요청 예 :

curl -X POST https://api.forwardemail.net/v1/domains/example.com/invites \
  -u API_TOKEN: \
  -d "email=user%40gmail.com" \
  -d group=admin

Example Response:

{
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "Invalid API token."
}

도메인 초대 제거

DELETE /v1/domains/:domain_name/invites

바디 파라미터	필수	유형	기술
`email`	예	문자열 (이메일)	도메인 회원 목록에서 제거 할 이메일 주소

요청 예 :

curl -X DELETE https://api.forwardemail.net/v1/domains/:domain_name/invites \
  -u API_TOKEN:

회원

도메인 멤버 업데이트

PUT /v1/domains/example.com/members/:member_id

바디 파라미터	필수	유형	기술
`group`	예	문자열 (열거 가능)	사용자를 도메인 구성원으로 업데이트 할 그룹 (`"admin"` 또는`"user"`)

요청 예 :

curl -X PUT https://api.forwardemail.net/v1/domains/example.com/members/:member_id \
  -u API_TOKEN:

도메인 회원 제거

DELETE /v1/domains/:domain_name/members/:member_id

요청 예 :

curl -X DELETE https://api.forwardemail.net/v1/domains/:domain_name/members/:member_id \
  -u API_TOKEN:

별명

도메인 별칭 검색

GET /v1/domains/example.com/aliases

요청 예 :

curl -X GET https://api.forwardemail.net/v1/domains/example.com/aliases \
  -u API_TOKEN:

Example Response:

{
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "Invalid API token."
}

새 도메인 별칭 만들기

POST /v1/domains/example.com/aliases

바디 파라미터	필수	유형	기술
`name`	예	끈	별명
`recipients`	예	문자열 또는 배열	수신자 목록 (줄 바꿈 / 공백 / 쉼표로 구분 된 문자열 또는 유효한 전자 메일 주소, 정규화 된 도메인 이름 ( "FQDN"), IP 주소 및 / 또는 웹 후크 URL 배열)
`description`	아니	끈	별명 설명
`labels`	아니	문자열 또는 배열	레이블 목록 (줄 바꿈 / 공백 / 쉼표로 구분 된 문자열 또는 배열이어야 함)
`is_enabled`	아니	부울	이 별칭을 사용하지 않도록 설정할지 여부 (사용하지 않으면 전자 메일은 라우팅되지 않지만 상태 코드는 성공적으로 반환 됨)

요청 예 :

curl -X POST https://api.forwardemail.net/v1/domains/example.com/aliases \
  -u API_TOKEN:

Example Response:

{
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "Invalid API token."
}

도메인 별칭 업데이트

PUT /v1/domains/example.com/aliases/:alias_id

바디 파라미터	필수	유형	기술
`name`	아니	끈	별명
`recipients`	예	문자열 또는 배열	수신자 목록 (줄 바꿈 / 공백 / 쉼표로 구분 된 문자열 또는 유효한 전자 메일 주소, 정규화 된 도메인 이름 ( "FQDN"), IP 주소 및 / 또는 웹 후크 URL 배열)
`description`	아니	끈	별명 설명
`labels`	아니	문자열 또는 배열	레이블 목록 (줄 바꿈 / 공백 / 쉼표로 구분 된 문자열 또는 배열이어야 함)
`is_enabled`	아니	부울	이 별칭을 사용하지 않도록 설정할지 여부 (사용하지 않으면 전자 메일은 라우팅되지 않지만 상태 코드는 성공적으로 반환 됨)

요청 예 :

curl -X PUT https://api.forwardemail.net/v1/domains/example.com/aliases/:alias_id \
  -u API_TOKEN:

도메인 별칭 삭제

DELETE /v1/domains/:domain_name/aliases/:alias_id

요청 예 :

curl -X DELETE https://api.forwardemail.net/v1/domains/:domain_name/aliases/:alias_id \
  -u API_TOKEN:

실제 데이터와 키가있는 문서가 필요하십니까?

API 설명서

이메일 전달 API

목차

라이브러리

기본 URI

입증

오류

현지화

쪽수 매기기

계정

계정 만들기

계정 검색

계정 업데이트

도메인

도메인 목록

도메인 만들기

도메인 검색

도메인 레코드 확인

도메인 업데이트

도메인 삭제

초대

도메인 초대 수락

도메인 초대 만들기

도메인 초대 제거

회원

도메인 멤버 업데이트

도메인 회원 제거

별명

도메인 별칭 검색

새 도메인 별칭 만들기

도메인 별칭 업데이트

도메인 별칭 삭제