カスタムトリガー接続ドキュメント

最終更新 2026/10/03

呼び出し方法は、Open APIドキュメントの呼び出し方法の説明を参照してください。

1. カスタムトリガータスクの作成

カスタムトリガーのトリガールールでトリガーシナリオを作成し、一意のシナリオIDを設定したうえで、このトリガータスクのトリガー主体IDのタイプを選択します。

Tip：ここでトリガールールを満たすシナリオIDとトリガー対象の主体IDは、サーバー側の設定と一致している場合にのみ正常にトリガーされます。

図中の番号：1はシナリオの新規作成で、「シナリオ」ドロップダウンの下部にある「+ シナリオ」をクリックします。2は「新規作成」ポップアップ内の「シナリオID」、3は「主体ID」です。

2. トリガーインターフェースの呼び出し

2.1 インターフェースURL

open/hermes/custom/trigger?token=xxx&projectId=11

2.2 リクエストメソッド

POST

2.3 Content-Type

application/json

2.4 リクエストQueryパラメータ

パラメータ名	サンプル値	パラメータタイプ	必須	パラメータの説明
eventuuid	xxx	String	はい	イベントの一意のID
projectId	11	int	はい	プロジェクトID
sceneId		String	はい	シナリオID
entityId		String	はい	シナリオの主体IDタイプの値：accountId/distinctId
eventTime		long	はい	イベント時間
eventTimezone		double	推奨（省略可）	イベント時間のタイムゾーン。デフォルトはサーバーのタイムゾーン

2.5 成功レスポンスの例

{
    "return_code": 0,
    "return_message": "success"
}

パラメータ名	サンプル値	パラメータタイプ	パラメータの説明
return_code	0	Integer	リターンコード
return_message	success	String	リターンメッセージ

2.6 エラーレスポンスの例

{
    "return_code": -1008,
    "return_message": "パラメータエラー"
}

2.7 エラーコードの説明

エラーコード	エラーの説明
-1008	パラメータエラー(hermes.open.service.error.eventtime.not_valid)
-1006	token認証失敗(error.auth.authority_forbidden.token)
-1005	操作頻度超過/インターフェースのレート制限(error.op.too_many_open_api_request)
-1023	シナリオ/タスクが存在しないか削除済み(error.op.not_existed_with_name)
-1011	タスクのステータスが実行中ではありません(hermes.open.service.error.task.status_not_working)
-1009	ユーザーが存在しません(hermes.open.service.error.user_id.not_exit)
-1108	イベントの重複(hermes.open.service.error.task.event_id.repeat)
-1004	システム異常(hermes.service.error.system.common)