Automation API
1 つのイベントソース、任意のクエリ、AND/OR 条件、順番に実行する 1〜8 個のアクションでルールを作成します。このリファレンスは OpenAPI ドキュメントのバージョン 6.0.0 に対応します。
サービス URL
デプロイ先から提供された Automation サービス URL を使用してください。元の仕様は相対 URL / を指定し、ルートにバージョンの接頭辞はありません。本番ホスト名は指定されていません。リファレンスからリクエストを送る前に、「サーバー」欄で https:// または http:// を含む完全なサービス URL を入力してください。ブラウザは Automation の各エンドポイント間でこの URL を保持します。
OpenAPI JSON をダウンロードできます。
認証
業務 API には automation スコープを持つ Key を CP-X-API-KEY ヘッダーで送信します。匿名アクセスが可能なのはヘルスチェックと CORS プリフライトのみです。
ルールと履歴は認証された Owner に属します。同じ Owner の Key は通常の管理権限を共有します。exec には、サーバーで許可された Key ID も必要です。GET /me で現在の認証情報を確認できます。
ルール定義
| フィールド | 用途 |
|---|---|
source | cron、incoming、price のいずれか 1 つ。価格条件が不成立から成立に変わるとイベントを生成し、最初の価格は基準値の設定にのみ使います。 |
queries | 最大 8 個の名前付きクエリ。イベントにデータを追加し、実行自体は開始しません。現在は price に対応します。 |
filters | 任意の AND/OR 式。text_contains と number_compare を使い、/data/... と /queries/<id>/... を参照します。 |
actions | 順番に実行する 1〜8 個の webhook または exec。単数形の action は受け付けません。 |
cooldown_minutes | 初期値は 0。クールダウン期間内のイベントはスキップします。 |
note | 任意のメモ。メモだけの変更では revision は増えません。 |
価格ソースとクエリにはサーバー側の Oracle 設定が必要です。exec は Linux/macOS で許可された Key ID にのみ提供されます。GET /types は現在の Key で利用できる型を返します。X とメールのアダプターは未実装です。