curl -X POST 'https://verification.didit.me/v3/bank/connections/5e1d2a70-3b94-4c1f-8a6e-d2f07b9c1e35/refresh/' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.bank.refresh_connection(
"11111111-2222-3333-4444-555555555555",
wait=True,
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.bank.refreshConnection("11111111-2222-3333-4444-555555555555", {
wait: true,
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Bank.RefreshConnection(ctx, "11111111-2222-3333-4444-555555555555", didit.BankRefreshConnectionParams{
Body: didit.BankRefreshRequest{
Wait: didit.Bool(true),
},
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
import me.didit.types.BankRefreshConnectionParams;
import me.didit.types.BankRefreshRequest;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.bank().refreshConnection("11111111-2222-3333-4444-555555555555", BankRefreshConnectionParams.builder()
.wait_(true)
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->bank->refreshConnection('11111111-2222-3333-4444-555555555555', [
'wait' => true,
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.bank.refresh_connection(
"11111111-2222-3333-4444-555555555555",
wait: true
)
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Bank.RefreshConnectionAsync("11111111-2222-3333-4444-555555555555", new BankRefreshRequest
{
Wait = true,
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"id": "d4a9e7b2-1c58-4f03-96ab-5e2d8c7f0b14",
"connection_id": "5e1d2a70-6b3c-4f8e-a1d9-0c7b2e4f8a36",
"trigger": "requested",
"status": "succeeded",
"started_at": "2026-11-21T12:30:02Z",
"finished_at": "2026-11-21T12:30:09Z",
"results": [
{
"account_id": "a71f0c2e-4d85-4b1a-9e63-2f8c0d5b7a14",
"resource": "transactions",
"outcome": "succeeded",
"added": 3,
"modified": 0,
"removed": 1,
"error": null
}
],
"outcome": "succeeded",
"balances_changed": true,
"error": null
}은행 연결 새로고침 API: 지금 동기화
Didit의 은행 연결 새로고침 엔드포인트는 즉시 동기화합니다. 202 응답과 sync_id를 반환하며, 최대 25초까지 기다리면 완료된 동기화 결과를 200으로 받을 수 있습니다.
curl -X POST 'https://verification.didit.me/v3/bank/connections/5e1d2a70-3b94-4c1f-8a6e-d2f07b9c1e35/refresh/' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.bank.refresh_connection(
"11111111-2222-3333-4444-555555555555",
wait=True,
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.bank.refreshConnection("11111111-2222-3333-4444-555555555555", {
wait: true,
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Bank.RefreshConnection(ctx, "11111111-2222-3333-4444-555555555555", didit.BankRefreshConnectionParams{
Body: didit.BankRefreshRequest{
Wait: didit.Bool(true),
},
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
import me.didit.types.BankRefreshConnectionParams;
import me.didit.types.BankRefreshRequest;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.bank().refreshConnection("11111111-2222-3333-4444-555555555555", BankRefreshConnectionParams.builder()
.wait_(true)
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->bank->refreshConnection('11111111-2222-3333-4444-555555555555', [
'wait' => true,
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.bank.refresh_connection(
"11111111-2222-3333-4444-555555555555",
wait: true
)
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Bank.RefreshConnectionAsync("11111111-2222-3333-4444-555555555555", new BankRefreshRequest
{
Wait = true,
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"id": "d4a9e7b2-1c58-4f03-96ab-5e2d8c7f0b14",
"connection_id": "5e1d2a70-6b3c-4f8e-a1d9-0c7b2e4f8a36",
"trigger": "requested",
"status": "succeeded",
"started_at": "2026-11-21T12:30:02Z",
"finished_at": "2026-11-21T12:30:09Z",
"results": [
{
"account_id": "a71f0c2e-4d85-4b1a-9e63-2f8c0d5b7a14",
"resource": "transactions",
"outcome": "succeeded",
"added": 3,
"modified": 0,
"removed": 1,
"error": null
}
],
"outcome": "succeeded",
"balances_changed": true,
"error": null
}202와 함께 sync_id를 응답합니다.
"wait": true를 보내면 최대 25초 동안 대기한 뒤 한 번의 호출로 완료된 동기화 결과를 받을 수 있으며, 추가 요금은 없습니다.
은행이 사용자가 없는 상태에서의 접근을 제한하므로, 호출 시 429 refresh_limit_reached 응답과 Retry-After가 반환될 수 있습니다.
온디맨드로 은행 데이터 새로 고침을 참고하세요.인증
귀사 애플리케이션의 API 키입니다. Business Console의 Developers -> API keys에서 확인할 수 있습니다. 기본 키는 모든 권한을 가집니다. 명명된 키는 범위를 지정할 수 있습니다. 리소스별로 권한 없음, 읽기 또는 쓰기를 설정할 수 있고, 일부 워크플로나 승인된 세션으로 제한할 수 있으며, 허용된 IP 목록으로 제한할 수 있고, 만료일을 설정할 수 있습니다. 401은 키가 잘못되었거나, 취소되었거나, 만료되었음을 의미합니다. 403은 키가 전송되지 않았거나, 키에 해당 리소스 또는 작업에 대한 권한이 없거나, 요청이 IP 목록 밖의 주소에서 왔음을 의미합니다. 세션 경로에서 발생한 404는 세션이 키의 워크플로 또는 상태 범위를 벗어났음을 의미합니다. 미디어 접근 권한이 없는 키는 이미지, 동영상 및 PDF URL을 null로 받으며, 세션 쓰기 권한이 없는 키는 세션 링크와 토큰을 null로 받습니다. 자세한 내용은 https://docs.didit.me/console/api-keys 를 참조합니다.
헤더
한 작업을 위해 직접 정하는 선택적 재시도 안전 키입니다. 최대 255자이며 UUID를 사용할 수 있습니다. 같은 키, 엔드포인트, 쿼리, 본문으로 반복된 요청에는 첫 번째 응답이 같은 상태 코드와 같은 본문으로 반환되며, 다시 실행되거나 다시 과금되지 않습니다. 같은 키를 다른 엔드포인트, 쿼리 또는 본문과 함께 사용하면 409 idempotency_key_reused가 반환되고, 첫 번째 요청이 아직 실행 중이면 Retry-After와 함께 409 idempotency_key_in_progress가 반환됩니다. 실패한 요청(모든 4xx 또는 5xx)은 저장되지 않으므로 같은 키로 다시 보낼 수 있습니다. 키는 API 키로 호출하든 액세스 토큰으로 호출하든 사용자의 애플리케이션에 속합니다. 재시도 및 멱등성을 참고하세요.
1 - 255본문
선택 사항입니다. 새로 고침 요청의 본문입니다.
true이면 최대 25초 동안 호출을 대기시키고, 동기화가 완료되면 200으로 응답하므로 한 번의 요청으로 최신 데이터를 받을 수 있습니다. 그 시간 안에 은행이 응답하지 않으면 호출은 202로 응답합니다. 이 경우 sync_id를 사용해 get_sync_run으로 동기화를 조회하거나 bank.sync.completed를 구독하십시오. bank.data.updated는 동기화에서 변경 사항이 저장된 경우에만 발송됩니다. Prefer: wait=<seconds> 헤더(최대 25)도 같은 역할을 합니다.
응답
동기화가 25초 이내에 완료되었습니다.
wait와 함께 요청한 갱신에서 반환된 완료된 동기화입니다. outcome이 포함된 동기화 실행, results의 계좌별 건수, balances_changed를 포함합니다.