Skip to content

Queue - Actualizar Fandata

Endpoint para crear objetos en la cola de procesamiento relacionados con la actualización de datos de Fanbase.

URLs

MétodoURLAcciónDescripción
POST/api/v1/integration/queueRegistrarCrea un objeto en la cola de procesamiento para actualización de datos
GET/api/v1/integration/queue/{id}VisualizarVerifica el estado de procesamiento de un objeto en la cola

Producción:

{connect-producao}/api/v1/integration/queue

Homologación:

{connect-homologacao}/api/v1/integration/queue

Autenticación

Todas las solicitudes requieren un token de acceso obtenido en el endpoint de Security. El token debe ser enviado en el header AccessToken.

Crear Objeto en la Cola

Solicitud

Endpoint: POST {connect-producao}/api/v1/integration/queue

Headers:

AccessToken: {access_token}
Content-Type: application/json

Body:

json
{
  "action": "update_fandata",
  "data": {
    "cpf": "12345678900",
    "id": "id_interno_feng"
  }
}

Campos del Body

CampoTipoObligatorioDescripción
cpfstring/nullNoCPF del usuario (puede ser nulo)
idstringID interno del sistema de origen

Respuesta de Éxito

Estado: 201 Created

json
{
  "id": "uuid-del-objeto",
  "created": "2025-01-01T00:00:00Z",
  "iCode": 0,
  "iMsg": "Objeto creado con éxito",
  "processDate": null,
  "processStatus": "pending",
  "processMsg": null
}

Verificar Procesamiento

Solicitud

Endpoint: GET {connect-producao}/api/v1/integration/queue/{id}

Headers:

AccessToken: {access_token}

Respuesta de Éxito

Estado: 200 OK

json
{
  "id": "uuid-del-objeto",
  "created": "2025-01-01T00:00:00Z",
  "iCode": 0,
  "iMsg": "Procesado con éxito",
  "processDate": "2025-01-01T00:05:00Z",
  "processStatus": "completed",
  "processMsg": "Datos actualizados con éxito"
}

Ejemplo de Implementación

javascript
async function actualizarFandata(datos, accessToken) {
  const response = await fetch('{connect-producao}/api/v1/integration/queue', {
    method: 'POST',
    headers: {
      'AccessToken': accessToken,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      action: 'update_fandata',
      data: datos
    })
  });

  if (!response.ok) {
    throw new Error(`Error ${response.status}: ${response.statusText}`);
  }

  return await response.json();
}

Documentación de la API Fanbase