メインコンテンツへスキップ
GET
curl
Diditの Sync Transactionsエンドポイントは、カーソル以降に接続の取引で変更された内容を返します:added、modified、removed。 カーソルが空の場合は、reset: true を付けてすべての取引を返します。 has_more: false のレスポンスを受け取った後にのみ next_cursor を保存してください。 詳しくは会計向けの継続的な銀行フィードをご覧ください。

承認

x-api-key
string
header
必須

お客様のアプリケーションのAPIキーです。Business Console の Developers -> API keys から取得できます。プライマリーキーはすべてのアクセス権を持ちます。名前付きキーは範囲を制限できます。リソースごとに none、read、write を指定でき、一部のワークフローや承認済みセッションに限定できます。IPアドレスのリストや有効期限も設定できます。401 はキーが誤っている、取り消されている、または期限切れであることを意味します。403 はキーが送信されていない、そのリソースまたはアクションへのアクセス権がない、またはリクエストがIPリストに含まれないアドレスから送信されたことを意味します。セッションのルートでの404 は、セッションがキーのワークフローまたはステータスの範囲外にあることを意味します。メディアへのアクセス権がないキーでは、画像、動画、PDFのURLが null で返されます。セッションの書き込み権限がないキーでは、セッションリンクとトークンが null で返されます。詳しくは https://docs.didit.me/console/api-keys を参照してください。

パスパラメータ

id
string<uuid>
必須

接続ID。

クエリパラメータ

cursor
string

保存しておいた next_cursor。空または省略した場合は先頭から開始します。

limit
integer
デフォルト:100

ページサイズ。1〜500。デフォルトは100。

必須範囲: 1 <= x <= 500
page_token
string

has_more が true の間、同じ読み取りを続けます。

レスポンス

変更のページです。

カーソル以降の接続のトランザクションの変更を返します。空のカーソルを指定すると、現在のすべてのトランザクションを added として返します。1回の読み取りのすべてのページは同じスナップショットを反映します。その間に発生した変更は次回の読み取りで返されます。

added
object[]
必須

追加する取引。最初の読み取り(カーソルなし、またはreset後)では、読み取り開始時に接続が持っていたすべての取引が、現在の状態で1回ずつ含まれます。ページング中に同期が実行されても同じです。以降の読み取りでは、カーソル以降の新しい取引と、保留中の取引を置き換える確定済みの取引が含まれます。

modified
object[]
必須

カーソル以降に変更された取引の、現在の状態。各取引をidをキーとしてupsertしてください。最初の読み取りでページングしている間に受け取った取引が、その間に変更されている場合は、ここにも再度届きます。銀行による修正もここで届きます。

removed
object[]
必須

reason付きの、もう存在しない取引。受け取っていないidは無視してください。最初の読み取りのページング中に削除された取引は、一度addedとして配信されており、次の読み取りでここに届きます。

has_more
boolean
必須

さらにページがある間は true になります。next_cursor は、has_more: false のレスポンスを受け取った後にのみ保存してください。ページ送り中に失敗した場合は、保存済みのカーソルから再開してください。

next_page_token
string | null
必須

has_more が true の間、この読み取りを続けます。

next_cursor
string | null
必須

フィードの永続的なチェックポイントです。最後のページにのみ返されます。不透明な値で、アプリケーション、環境および接続に紐付けられます。90日間再生可能です。初回の読み取りでは、読み取りを開始した時点を示すため、その後に発生した変更は次回の読み取りで届きます。

reset
boolean
必須

空のカーソルからのすべての読み取り(初回取得)では、常に true になります。結果を既存のデータに追加するのではなく、保存済みのコピーを結果で置き換えてください。

最終更新日 2026年11月22日