Saltar al contingut principal
POST
curl
L’endpoint «Refrescar una connexió bancària» de Didit sol·licita una sincronització immediata i respon amb 202 i el sync_id. Envia "wait": true per esperar fins a 25 segons i obtenir la sincronització finalitzada en una sola crida, sense cost addicional. El banc limita l’accés sense supervisió, de manera que la crida pot respondre 429 refresh_limit_reached amb Retry-After. Consulta Actualitza les dades bancàries sota demanda.

Autoritzacions

x-api-key
string
header
requerit

La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau principal té accés complet. Una clau amb nom es pot limitar: cap, lectura o escriptura per recurs, limitada a alguns fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 vol dir que la clau és incorrecta, revocada o caducada; 403 vol dir que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud ve d'una adreça fora de la seva llista d'adreces IP; 404 en una ruta de sessió vol dir que la sessió queda fora dels fluxos de treball o estats de la clau. Una clau sense accés a multimèdia rep les URL d'imatges, vídeos i PDF com a null, i una clau sense escriptura de sessions rep els enllaços i els tokens de sessió com a null. Vegeu https://docs.didit.me/console/api-keys.

Capçaleres

Idempotency-Key
string

Clau opcional de seguretat per a reintents que tu tries per a una operació, de fins a 255 caràcters (un UUID funciona). Una sol·licitud repetida amb la mateixa clau, endpoint, consulta i cos rep la primera resposta, amb el mateix codi d'estat i el mateix cos, i no s'executa ni es factura una segona vegada. La mateixa clau amb un altre endpoint, consulta o cos retorna 409 idempotency_key_reused, i mentre la primera sol·licitud encara s'està processant, 409 idempotency_key_in_progress amb Retry-After. Una sol·licitud fallida (qualsevol 4xx o 5xx) no s'emmagatzema, de manera que pots tornar-la a enviar amb la mateixa clau. Les claus pertanyen a la teva aplicació, tant si crides amb una clau d'API com amb un token d'accés. Consulta Reintents i idempotència.

Required string length: 1 - 255
Prefer
string

wait=<seconds> manté la crida fins a aquest nombre de segons, com a màxim 25, igual que wait: true al cos de la sol·licitud.

Exemple:

"wait=25"

Paràmetres de ruta

id
string<uuid>
requerit

L'id de la connexió.

Cos

application/json

Cos opcional d'una actualització.

wait
boolean
predeterminat:false

true manté la crida fins a 25 segons i respon 200 amb la sincronització acabada, de manera que una sola sol·licitud retorna dades actualitzades. Si el banc no ha respost en aquest temps, la crida respon 202: llegeix la sincronització amb get_sync_run fent servir el sync_id, o subscriu-te a bank.sync.completed. bank.data.updated només s'envia quan la sincronització emmagatzema canvis. La capçalera Prefer: wait=<seconds> (fins a 25) fa el mateix.

Resposta

La sincronització ha acabat en un màxim de 25 segons.

Una sincronització finalitzada retornada per una actualització amb wait: l'execució de sincronització amb el seu outcome, els recomptes per compte a results i balances_changed.

id
string<uuid>
requerit
connection_id
string<uuid>
requerit
trigger
enum<string>
requerit
Opcions disponibles:
initial,
scheduled,
requested
status
enum<string>
requerit
Opcions disponibles:
queued,
running,
succeeded,
partial,
failed
started_at
string<date-time> | null
requerit
finished_at
string<date-time> | null
requerit
results
object[]
requerit

Què ha fet l'execució, per compte i recurs.

error
object | null
requerit

Per què ha fallat l'execució en conjunt. null quan no ha fallat. Els errors de comptes i recursos individuals són a results.

outcome
enum<string>
requerit

Com va acabar la sincronització.

Opcions disponibles:
succeeded,
partial,
failed
balances_changed
boolean
requerit

Si ha canviat algun saldo.

Darrera modificació el 22 de novembre del 2026