Skip to content

ジョブの同期状況を一覧表示

get

/cdi/integrations/{integration_id}/job_sync_status

このエンドポイントを使用して、指定した統合の過去の同期ステータスのリストを返します。

レート制限

This endpoint has a rate limit of 100 requests per minute.

経路パラメータ

パラメータ|必須|データ型|説明      
integration_id 必須 文字列 統合 ID。

クエリパラメーター

このエンドポイントを呼び出すと、10個のアイテムが返される。10回以上の同期がある統合では、次の応答例に示すように、Link ヘッダーを使用して、次のページのデータを取得します。

パラメータ|必須|データ型|説明
cursor |オプション|文字列|同期ステータスのページ分割を決定します。

リクエスト例

カーソルなし

1
2
3
curl --location --request GET 'https://rest.iad-03.braze.com/cdi/integrations/00000000-0000-0000-0000-000000000000/job_sync_status' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY'

カーソル付き

1
2
3
curl --location --request GET 'https://rest.iad-03.braze.com/cdi/integrations/00000000-0000-0000-0000-000000000000/job_sync_status?cursor=c2tpcDow' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY'

応答

成功応答例

ステータスコード200 、以下のレスポンスボディを返すことができる。

1
Link: </cdi/integrations/00000000-0000-0000-0000-000000000000/job_sync_status?cursor=c2tpcDow>; rel="prev",</cdi/integrations00000000-0000-0000-0000-000000000000/job_sync_status?cursor=c2tpcDoxMDA=>; rel="next"
1
2
3
4
5
6
7
8
9
10
11
12
13
{
  "results": [
    {
        "job_status": (string) status of the sync, see below for explanation of different statuses,
        "sync_start_time": (string) time the sync started in ISO 8601,
        "sync_finish_time": (string) time the sync finished in ISO 8601,
        "last_timestamp_synced": (string) last UPDATED_AT timestamp processed by the sync in ISO 8601,
        "rows_synced": (integer) number of rows successfully synced to Braze,
        "rows_failed_with_errors": (integer) number of rows failed because of errors,
    },
  ],
  "message": "success"
}

|job_status|ジョブステータス | — | — | |running | ジョブは現在実行中です。| |success |すべての行が正常に同期されました。| |partial | エラーにより一部の行の同期に失敗しました。| |error | 同期された行はありません。| |config_error |統合設定にエラーが発生しました。統合設定を確認してください。|

トラブルシューティング

次の表は、返される可能性のあるエラーと、それに関連するトラブルシューティングの手順を示したものです。

トラブルシューティング
400 Invalid cursorcursor |が有効であることを確認する。
400 Invalid integration IDintegration_id |が有効であることを確認する。

その他のステータスコードと関連するエラーメッセージについては、致命的なエラーと応答を参照してください。

「このページはどの程度役に立ちましたか?」
New Stuff!