配達ポリシー — ハトが従う配達の規定
配達ポリシーは、ハトがLetterを送るときのHTTP設定・タイムアウト・再試行・サイズ上限を定めます。同じポリシーを複数のリクエストで共有できます。
- 配達方法を設定： タイムアウトの閾値、リトライ条件やリトライ回数、リクエストとレスポンスのサイズなど設定可能です。
- プロトコルへの対応: HTTP1.1, HTTP2, HTTP3, FTP, SFTP
- 再利用可能なプロファイル: 配達ポリシーの設定を複数のレターで共有可能。環境切り替えを簡略化します。
鳩の郵便局でAPIを自動化
Hato APIはハトの郵便局です。従業員のハトが従う配達ポリシーを設定し、リクエストをLetterに書き、Letterflowでつないで、Letterboxで結果を確認できます。
コアコンセプト
5つのシンプルな概念
Letter — リクエストコンポーネント
LetterflowにLetterコンポーネントを追加し、メソッド、URL、ヘッダー、ボディ、リージョン、配達ポリシーを選びます。
- リクエスト設定： 各リクエストをLetterflowビルダー内で直接設定します。
- 様々な配達方法: ハトはレターを一度だけ、繰り返し、またはスケジュールに従って配達できます。
- 送信元の設定: 指定の地域からレターを送信することができます。
Directory — Letterflowで共有する値
暗号化したリージョンの値、ヘッダー、認証情報をLetterflow間で共有します。
- 再利用できる変数： テキスト、シークレット、JSON、XMLを保存し、Letterflowから参照できます。
- リクエスト設定の共有： ヘッダー、ログイン認証情報、秘密鍵を複数のLetterで共有できます。
- リージョンごとの保護： 選択したリージョンに値を暗号化して保存します。
レターフロー — 配達とデータ処理をつなぐ
複数のレター繋げることができます。その際、取り出すデータを選択したり、次に渡すデータを加工したりすることができます。ルーティンワークをハトたちに任せて簡素化・自動化を実現します。
- 2Dキャンバス: 様々なコンポーネントをキャンバスに配列してデータフローを作成します。
- 変数の対応: 二重波括弧 {{ }} を使って前のコンポーネントを参照できます。またパイプ ( | ) を使い簡単な関数を呼びだし出力を変更できます。
- 柔軟な条件分岐: HTTPステータスコードやレスポンスの値に応じて実行ルートを動的に分岐。
レターボックス — レスポンスの保存場所
配達結果が届く受信箱です。レスポンスの詳細をここで確認できます。
- データ保護: レスポンスが保管される地域はレター送信元と同じになります。またデータは保存時暗号化されます。
- 直感的なレスポンス可視化: 実行されたレターやコンポーネント、そのリクエストとレスポンスの情報を簡単に確認できます。
- ピン留め & 保持ポリシー: レスポンスの保存数と保存期間には上限があります。重要なレスポンスをピン留めして保持しましょう。
使い方の流れ
3ステップでリクエストを送信して結果を確認
1
設定と作成
Letterflowを作成し、Letterコンポーネントを追加して配達ポリシーを選びます。
2
手動実行またはスケジュール
Letterflowを手動で実行するか、単発または繰り返しのスケジュールを設定します。
3
レターボックスで確認
レターボックスでレスポンスを確認。メッセージ、応答時間、ステータス、など確認し、重要なレスポンスをピン留めします。
サブスクリプションとプラン
シンプルなプラン、透明性のある制限。
自動配達のLetterflowに合うプランを選びます。無料で始めて、必要に応じて拡張できます。
現地通貨での価格は概算です。決済時の金額と多少異なる場合があります。
税金の取り扱いは所在地により異なります。最終的な通貨、税額、合計金額は決済画面に表示されます。
| 項目 | Tinkerer USD 0 / 永久無料 | Aspiring USD 5 / 月 USD 5 / 月 | 説明 |
|---|---|---|---|
| おすすめの用途 | 評価、趣味のプロジェクト、Webhook向け。 | 活発な開発者と小規模な本番処理向け。 | 利用規模に合ったプランを選択してください。 |
| レターフロー | 3 | 15 | 1つ以上のコンポーネントをつなぐ保存済みLetterflowです。 |
| Directory | 5 | 30 | 暗号化したリージョンの値、ヘッダー、認証情報をLetterflow間で共有します。 |
| 配達ポリシー | 1 | 5 | API送信時の設定（プロトコル・タイムアウトなど）の保存数です。 |
| 配達数 / 時間 | 12 | 180 | 直近1時間に接続先へ到達した試行数です。リダイレクトと再試行を含みます。 |
| Letterflowメール／月 | 利用不可 | 1000 | フローとリージョンで共有し、毎月1日00:00 UTCにリセットします。 |
| Letterflowメール／時間 | 利用不可 | 20 | APIリクエストの試行回数とは別の、直近1時間の通知メール上限です。 |
| 同時実行数 | 1 | 3 | 1つのLetterまたはLetterflow全体で同時実行枠を1つ使用します。 |
| 待機できる配達数 | 2 | 6 | 同時実行枠や時間あたりの利用枠が空くまで待機します。スケジュール配信は別途有効にします。 |
| 最小実行間隔（分） | 10 | 1 | 繰り返し配信とcronスケジュールに指定できる最短間隔です。 |
| レターフローのリージョン | 単一リージョン | 複数リージョン | 単一リージョン内で実行、または複数リージョンを連携させて実行できます。 |
| APIキー | 1 | 3 | 有効なAPIキー数です。利用できる権限はプランによって異なります。 |
| API の権限 |
|
|
明示的に権限を選択したキーで利用できる権限です。アカウント固有の制限が異なる場合があります。 |
| 保持期間（日） | 14 | 60 | 実行内容の保存期間です。固定したエントリは自動失効しません。 |
| レターボックスの保存件数 | 10 | 80 | 実行結果の保存数です。上限に達すると、固定されていない古い結果から置き換わります。 |
| Startを除くコンポーネント | 6 | 15 | 各Letterflowに配置できるコンポーネントの合計数です。 |
| レターコンポーネント | 2 | 5 | 1つのレターフローに配置できるレターコンポーネントの上限です。 |
| リクエストボディ (MiB) | 3 | 15 | 送信試行1回あたりのリクエストボディの最大サイズです。 |
| レスポンスボディ (MiB) | 3 | 20 | 送信試行1回あたりのレスポンスボディの最大サイズです。 |