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

가입하거나 로그인하면 아래에 API 키와 실제 계정 데이터가 채워집니다.

개인 정보 보호 정책 및 약관을 읽으십시오

관심이 없다? 계속 읽으려면 여기를 클릭하십시오

도메인, 별칭 등에 프로그래밍 방식으로 액세스 할 수있는 API를 만들었습니다.

🤖

API 설명서

데이터에 프로그래밍 방식으로 액세스

이메일 전달 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 interchangeable 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")
catchall 아니 String (delimited email addresses) or Boolean Create a default catch-all alias, defaults to true (if true it will use the API user's email address as a recipient, and if false no catch-all will be created). If a String is passed, then it is a delimited list of email addresses to use as recipients (separated by line break, space, and/or comma)

요청 예 :

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: