Skip to content

Queue - Update Fandata

Endpoint para criar objetos na fila de processamento relacionados à atualização de dados do Fanbase.

URLs

MétodoURLAçãoDescrição
POST/api/v1/integration/queueCadastrarCria um objeto na fila de processamento para atualização de dados
GET/api/v1/integration/queue/{id}VisualizarVerifica o status de processamento de um objeto na fila

Produção:

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

Homologação:

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

Autenticação

Todas as requisições requerem um token de acesso obtido no endpoint de Security. O token deve ser enviado no header AccessToken.

Criar Objeto na Fila

Requisição

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 do Body

CampoTipoObrigatórioDescrição
cpfstring/nullNãoCPF do usuário (pode ser nulo)
idstringSimID interno do sistema de origem

Resposta de Sucesso

Status: 201 Created

json
{
  "id": "uuid-do-objeto",
  "created": "2025-01-01T00:00:00Z",
  "iCode": 0,
  "iMsg": "Objeto criado com sucesso",
  "processDate": null,
  "processStatus": "pending",
  "processMsg": null
}

Verificar Processamento

Requisição

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

Headers:

AccessToken: {access_token}

Resposta de Sucesso

Status: 200 OK

json
{
  "id": "uuid-do-objeto",
  "created": "2025-01-01T00:00:00Z",
  "iCode": 0,
  "iMsg": "Processado com sucesso",
  "processDate": "2025-01-01T00:05:00Z",
  "processStatus": "completed",
  "processMsg": "Dados atualizados com sucesso"
}

Exemplo de Implementação

javascript
async function atualizarFandata(dados, 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: dados
    })
  });

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

  return await response.json();
}

Documentação da API Fanbase