プロジェクトプロパティ

このページは機械翻訳により提供されています。翻訳内容と英語版に相違がある場合は、英語版が優先されます。

次のエンドポイントを使用して、プロジェクトプロパティをプログラムで管理します。

レート制限

プロジェクトプロパティリソースには、次のレート制限があります:

タイプリソース制限
すべてすべてのプロジェクトプロパティエンドポイント1分あたり60リクエスト

クイックリファレンス

タイプリソース説明
GET/api/propertiesプレフィックスとプロジェクトIDに一致するプロジェクトレベルのプロパティを一覧表示します。
POST/api/propertiesプロジェクトレベルのプロパティをアップサートします。

プロジェクトプロパティの一覧表示

指定したproject_idに一致する、顧客ワークスペース内の特定のプロジェクトに属するプロジェクトレベルのプロパティのリストを返します。 プレフィックスも含める必要があります。 たとえば、プレフィックスsalesforce_sync.を指定すると、指定したproject_idを持つ、salesforce_sync.admin_emailなどのsalesforce_sync.で始まる名前のプロジェクトプロパティが返されます。

GET /api/properties

クエリパラメーター

名前タイプ説明
prefixstring
必須
指定したプレフィックスを含むプロパティを返します。 たとえば、プレフィックスがsalesforce_sync.の場合、プロパティsalesforce_sync.admin_emailが返されます。
project_idstring
必須
指定したproject_idに一致するプロジェクトレベルのプロパティを返します。 このパラメータが存在しない場合、この呼び出しはEnvironment propertiesを返します。

サンプルリクエスト

shell
curl  -X GET 'https://www.workato.com/api/properties?prefix=salesforce_sync.&project_id=523144' \
      -H 'Authorization: Bearer <token>' \
      -H 'Content-Type: application/json'

レスポンス

json
{
  "public_url": "https://www.example.com",
  "admin_email": "[email protected]"
}

プロジェクトプロパティのアップサート

指定したproject_idに一致する、顧客ワークスペース内の特定のプロジェクトに属するプロジェクトプロパティをアップサートします。 このエンドポイントは、リクエストで指定した名前に基づいてプロパティにマッピングされます。

POST /api/properties

プロパティ制限

プロジェクトプロパティには、次の制限があります:

説明制限
プロジェクトあたりのプロジェクトプロパティの最大数1,000
プロジェクトプロパティ名の最大長100文字
プロジェクトプロパティ値の最大長1,024文字

クエリパラメータ

名前タイプ説明
project_idstring
必須
アップサートするプロジェクトプロパティを含むプロジェクトIDを指定します。 このパラメータが存在しない場合、この呼び出しはEnvironment propertiesをアップサートします。

ペイロード

名前タイプ説明
propertiesハッシュ
必須
アップサートするプロパティの名前と値を含みます。

サンプルリクエスト

shell
curl  -X POST 'https://www.workato.com/api/properties?project_id=523144' \
      -H 'Authorization: Bearer <token>' \
      -H 'Content-Type: application/json' \
      -d '{ "properties": { "admin_email": "[email protected]", "public_url": "https://www.example.com" }}'

レスポンス

json
{
  "success": true
}

Last updated: