Skip to main content
La Bulk API permite que tu aplicación actúe a través de muchos usuarios de Fluz conectados en una sola llamada, en lugar de iterar sobre un token de usuario a la vez. Está diseñada para desarrolladores de aplicaciones OAuth que necesitan leer o (pronto) mover fondos en nombre de los usuarios que se han conectado a tu app.
Esto es diferente de la operación “Create Virtual Card Bulk Order” en Virtual Cards, que crea muchas tarjetas para una sola cuenta. La Bulk API opera a través de tus usuarios conectados.

​
Quién puede usarla

La Bulk API está restringida a nivel de aplicación. Tu app debe tener la capacidad de Bulk API habilitada por Fluz; contáctanos para solicitar acceso. Las llamadas que no provienen de una aplicación con bulk habilitado se rechazan con BulkApiAccessDenied.

​
Autenticación

Todas las llamadas de Bulk API usan autenticación Basic con la clave de API de tu aplicación (tu client_id y client_secret), no un token de acceso de usuario:
Endpoint (staging):
Endpoint (producción):

​
La autorización proviene de conexiones existentes

La Bulk API nunca crea una nueva superficie de consentimiento. Un usuario solo es alcanzable si tiene una concesión OAuth activa con tu aplicación, y cada operación solo está permitida cuando el usuario ha otorgado los scopes que esa operación requiere. El acceso bulk nunca es más amplio que la operación equivalente de un solo usuario.
  • Desconectarse elimina la concesión, por lo que un usuario desconectado simplemente deja de ser alcanzable.
  • Si la concesión de un usuario está limitada a cuentas de gasto específicas, los resultados bulk para ese usuario se restringen automáticamente a esas cuentas.

​
Seleccionar usuarios objetivo

Cada operación bulk toma un targetSpec:
  • Los usuarios se direccionan por el externalReferenceId que proporcionaste cuando se conectaron — no por accountId.
  • Una solicitud sincrónica direcciona como máximo 100 objetivos.
  • Los usuarios conectados sin un externalReferenceId no pueden seleccionarse individualmente; solo son alcanzables mediante ALL_CONNECTED. Usa Discover Connected Users para ver quién está conectado y qué scopes otorgaron.

​
Contrato de fallas por objetivo

La falla de un objetivo nunca falla toda la solicitud. Cada resultado lleva success y, cuando success es false, un error: Toda la solicitud solo se rechaza por problemas a nivel de aplicación: no tener bulk habilitado, una solicitud inválida, exceder el límite de 100 objetivos o cuando cada objetivo solicitado es irresoluble. Cada respuesta también resume targetCount, successCount y failureCount.

​
Sincrónico vs. asincrónico

  • Lecturas acotadas son sincrónicas y se sirven en línea: hasta 100 objetivos, con límites por objetivo (p. ej., 20 transacciones cada uno, una ventana de 90 días). Estas son las tres consultas documentadas en esta sección.
  • Escrituras y exportaciones grandes son asincrónicas (próximamente): envías un job, sondeas su estado y descargas los resultados. hasNextPage/totalCount en las lecturas sincrónicas te indican cuándo cambiar a una exportación en lugar de truncar silenciosamente.

​
Operaciones en esta sección