発表日 | ロールアウト日 |
2024年10月28日 | 2024年10月28日 |
リクエストの前の1分間に行われた変更を除外するため、インクリメンタルエクスポートAPIが変更されたことをお知らせします。
このお知らせの内容は以下のとおりです。
変更内容
これまでは、インクリメンタルエクスポートAPIはリクエストの時点までのデータを含めようとしていました。ただし、このやり方ではデータが不正確になる可能性があるため、この動作を変更します。リクエストの前の1分間に発生したすべてのチケットの作成と更新が除外されるようになりました。
APIは、記録された終了時間にこれを考慮するため、後続のリクエストでは中断したところからシームレスに再開することができます。
「チケットイベントのエクスポート」および「チケットイベントのインクリメンタルエクスポートAPI」を参照してください。
Zendeskがこれらの変更を行う理由
Zendesk は正確なデータの提供に尽力しています。この変更により、競合状態によって不良データが返される可能性が回避されます。これは、1つのチケットに対して短期間に複数の変更が実行された場合に発生する可能性があります。1分間の遅延がないと、チケットイベントのインクリメンタルAPIから受信するデータは、チケットの実際の状態を反映しない可能性があります。
このため、ZendeskではチケットイベントのインクリメンタルAPIの使用期間に制限を設けております。この新しい制限では、過去1分以内に作成または更新されたリソースは除外されます。
変更に伴う影響
この変更は、チケットイベントのインクリメンタルAPIを使用しているすべてのZendesk Supportのカスタマーに影響しますが、最新の1分間のチケットデータを結果に表示しようとしているカスタマーのみに通知されることになります。
提供終了に伴い必要となる作業
何もする必要はありません。結果の最後の1分間は、結果のAPIペイロードに含まれず、後続のリクエストに対して返されるタイムスタンプは、APIが中断した場所を反映します。ただし、このエンドポイントに依存しているチームには、最新の1分間のアクティビティは表示されないことを通知する必要があります。
この発表に関連するフィードバックや質問がある場合は、コミュニティフォーラムにアクセスしてください。このフォーラムでは、顧客から寄せられた製品フィードバックを収集し管理しています。Zendesk製品に関する一般的なサポートについては、Zendeskカスタマーサポートにお問い合わせください。
0件のコメント