プロジェクトプロパティ
次のエンドポイントを使用して、プロジェクトプロパティをプログラムで管理します。
レート制限
プロジェクトプロパティリソースには、次のレート制限があります:
| タイプ | リソース | 制限 |
|---|---|---|
| すべて | すべてのプロジェクトプロパティエンドポイント | 1分あたり60リクエスト |
クイックリファレンス
| タイプ | リソース | 説明 |
|---|---|---|
| GET | /api/properties | プレフィックスとプロジェクトIDに一致するプロジェクトレベルのプロパティを一覧表示します。 |
| POST | /api/properties | プロジェクトレベルのプロパティをアップサートします。 |
プロジェクトプロパティの一覧表示
指定したproject_idに一致する、顧客ワークスペース内の特定のプロジェクトに属するプロジェクトレベルのプロパティのリストを返します。 プレフィックスも含める必要があります。 たとえば、プレフィックスsalesforce_sync.を指定すると、指定したproject_idを持つ、salesforce_sync.admin_emailなどのsalesforce_sync.で始まる名前のプロジェクトプロパティが返されます。
GET /api/propertiesクエリパラメーター
| 名前 | タイプ | 説明 |
|---|---|---|
| prefix | string 必須 | 指定したプレフィックスを含むプロパティを返します。 たとえば、プレフィックスがsalesforce_sync.の場合、プロパティsalesforce_sync.admin_emailが返されます。 |
| project_id | string 必須 | 指定した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_id | string 必須 | アップサートするプロジェクトプロパティを含むプロジェクト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: