メール転送API

図書館

現在、APIラッパーはまだリリースされていませんが、近いうちにリリースする予定です。にメールを送信api@forwardemail.net 特定のプログラミング言語のAPIラッパーがリリースされたときに通知を受け取りたい場合。その間、アプリケーションでこれらの推奨されるHTTPリクエストライブラリを使用するか、単にカール以下の例のように。

言語	図書館
ルビー	ファラデー
パイソン	リクエスト
ジャワ	OkHttp
PHP	がたがた
JavaScript	スーパーエージェント
Node.js	スーパーエージェント
行く	net / http
。ネット	RestSharp

ベースURI

現在のHTTPベースURIパスは次のとおりです。https://api.forwardemail.net。のレガシーHTTPベースURIパスhttps://forwardemail.net:4000 2021年1月1日に非推奨になります。

認証

すべてのエンドポイントには、無料のAPIキー theリクエストの「username」値として設定されます基本認証ヘッダ。心配しないでください–これが何であるかわからない場合は、以下に例を示します。

エラー

エラーが発生した場合、APIリクエストのレスポンス本文には詳細なエラーメッセージが含まれます。 APIの作成とドキュメント化の経験が10年以上あることに加えて、ストライプ私たちが作成したときの美しいAPIドキュメント。

コード	名前
200	OK
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アドレス、Webhook 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アドレス、Webhook 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

認証

エラー

ローカリゼーション

ページネーション

アカウント

アカウントを作成する

アカウントを取得する

アカウントを更新する

ドメイン

ドメインの一覧表示

ドメインを作成

ドメインを取得

ドメインレコードを確認する

ドメインを更新

ドメインを削除

招待する

ドメインへの招待を受け入れる

ドメイン招待を作成

ドメインへの招待を削除

会員

ドメインメンバーを更新する

ドメインメンバーを削除

エイリアス

ドメインエイリアスを取得する

新しいドメインエイリアスを作成する

ドメインエイリアスを更新する

ドメインエイリアスを削除