Loading...

お知らせ:

当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

IDによるWebhookジョブの送信

説明

このAPIを使用すると、Webhookエンドポイントをトリガーするジョブをジョブプールに送信できます。

リクエスト詳細

リクエストURL

POST

{api-domain}/baas/v1/project/{project_id}/job_scheduling/job

copy

project_id
Numerical

リクエストヘッダー

Authorization: Zoho-oauthtoken {oauth_token}
Content-Type: application/json

オプションヘッダー

CATALYST-ORG: {org_id}

Environment: Development

スコープ

ZohoCatalyst.job.CREATE

リクエストJSON

以下に示す対応する値を含むJSONを送信する必要があります。

サンプルペイロード
copy
{
"request_method": "post",
"source_type": "API",
"job_config": {
    "number_of_retries": "2",
    "retry_interval": 1800
},
"job_name": "webhookPost",
"jobpool_id": "10108000003823632",
"target_type": "Webhook",
"url": "https://www.zoho.com",
"headers": {
    "h1": "v1"
},
"request_body": "{'key1':'val1'}"
}
View more

このリクエストJSONをリクエストボディに設定し、以下の値を指定する必要があります:

request_method
mandatory
webhookがトリガーされるリクエストメソッドを示します。値はget、post、put、delete、head、またはpatchを指定できます。
source_type
mandatory
ジョブ送信APIの場合、常にAPIを値として含みます。
job_config JSON
mandatory
number_of_retriesとretry_intervalのキーバリューペアが含まれます。失敗時のリトライアクションを決定します。
target_type String
mandatory
ジョブがトリガーするターゲットタイプを示します。
jobpool_id Numerical
mandatory
ジョブを実行するジョブプールのJob Pool IDが含まれます。
job_name String
mandatory
トリガーするジョブの名前が含まれます。
url String
mandatory
ジョブがトリガーするwebhookのURLが含まれます。
headers JSON
optional
ジョブ送信時に渡すヘッダーの値が含まれます。
params JSON
optional
ジョブ送信時に渡すパラメータの値が含まれます。

レスポンス詳細

JSONレスポンスは、送信されたジョブのメタデータを返します。レスポンスには、ジョブを送信したユーザーの詳細も含まれます。

リクエスト例
copy

curl -X POST
https://api.catalyst.zoho.com/baas/v1/project/{project_id}/job_scheduling/job -H “Authorization: Zoho-oauthtoken 1000.91016.2f57” -H “Content-Type:application/json” --data-raw $’{“request_method”:“post”,“source_type”:“API”,“job_config”:{“number_of_retries”:“2”,“retry_interval”:1800},“job_name”:“webhookPost”,“jobpool_id”:“10108000003823632”,“target_type”:“Webhook”,“url”:“https://www.zoho.com”,“headers”:{“h1”:“v1”},“request_body”:"{'key1':'val1'}"}'

レスポンス例
copy
{
"status": "success",
"data": {
    "job_id": "10108000004194125",
    "created_time": "Jun 05, 2024 04:37 PM",
    "response_code": null,
    "start_time": {},
    "end_time": {},
    "submitted_on": {
    "startTimeToRedirectLogsPage": "05/06/2024 16:32",
    "timeWithGivenTimezone": "Jun 05, 2024 04:37 PM IST",
    "timeWithJobTimezone": "Jun 05, 2024 04:37 PM IST"
    },
    "job_status": "PENDING",
    "capacity": {
    "number": "1"
    },
    "job_meta_details": {
    "id": "10108000004194126",
    "url": "https://www.zoho.com",
    "job_name": "webhookPost",
    "job_config": {
        "number_of_retries": 2,
        "retry_interval": 1800
    },
    "target_type": "Webhook",
    "target_details": {
        "target_name": "https://www.zoho.com"
    },
    "source_type": "API",
    "source_details": {
        "source_name": "API"
    },
    "jobpool_id": "10108000003823632",
    "jobpool_details": {
        "type": "Webhook",
        "name": "VendorDataFetch",
        "created_by": {
        "zuid": "77941453",
        "is_confirmed": false,
        "email_id": "emmy@zylker.com",
        "first_name": "Amelia Burrows",
        "last_name": "",
        "user_type": "Admin",
        "user_id": "10108000000009004"
        },
        "created_time": "May 28, 2024 04:47 PM",
        "modified_by": {
        "zuid": "77941453",
        "is_confirmed": false,
        "email_id": "emmy@zylker.com",
        "first_name": "Amelia Burrows",
        "last_name": "",
        "user_type": "Admin",
        "user_id": "10108000000009004"
        },
        "modified_time": "May 28, 2024 04:47 PM",
        "project_details": {
        "project_name": "ZylkerShipments",
        "id": "10108000003823392",
        "project_type": "Live"
        },
        "id": "10108000003823632"
    },
    "headers": {
        "h1": "v1"
    },
    "params": {},
    "request_method": "post",
    "request_body": "{'key1':'val1'}"
    },
    "retried_count": null,
    "parent_job_id": "10108000004194125",
    "execution_time": null
}
}
View more