API で送る

自分のサーバーのコードから直接送ります。認証は APIキー（Bearer）です。ブラウザからは叩かないでください（キーが露出します）。 静的サイトの場合はサイトのフォームを使います。

送り先

POST https://tsubamemail.com/api/v1/endpoints/<トークン>/submissions
Authorization: Bearer <APIキー>
Content-Type: application/json

APIキー

API 経路の受信口の設定 →「接続方法」で発行します。発行時に一度だけ表示され、以後は取り出せません （ハッシュで保存しているため）。分からなくなったら新しく発行して、 古いものを失効させてください。

キーはアカウント単位です。1本で、そのアカウントの API 経路の 受信口すべてに送れます（どの受信口かはURLで決まります）。 受信口が増えたときは、発行済みのキーを使い回すか、新しく発行するかを選べます。 失効はアカウント全体に効くので、同じキーを他の受信口でも使っている場合は そちらも送れなくなります。

本文の形

fields に項目を入れます。キーは日本語でも構いません。

{
  "fields": {
    "name": "山田太郎",
    "email": "yamada@example.com",
    "subject": "見積もりの相談",
    "message": "詳細をお送りください"
  }
}

fields で包まず、キーを直接並べた JSON でも同じように扱います。

応答

201 Created
{ "ok": true, "id": "受信ログのID", "note": "accepted" }

試す

curl -X POST https://tsubamemail.com/api/v1/endpoints/<トークン>/submissions \
  -H 'authorization: Bearer <APIキー>' \
  -H 'content-type: application/json' \
  -d '{"fields":{"name":"山田太郎","email":"yamada@example.com","message":"お問い合わせ内容"}}'