Queue - Update Fandata

Endpoint to create objects in the processing queue related to Fanbase data updates.

📥 Postman Collection

Download Collection - Queue Integration

URLs

Method	URL	Action	Description
POST	/api/v1/integration/queue	Register	Creates an object in the processing queue for data update
GET	/api/v1/integration/queue/{id}	View	Checks the processing status of an object in the queue

Production:

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

Staging:

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

Authentication

All requests require an access token obtained from the Security endpoint. The token must be sent in the AccessToken header.

Create Object in Queue

Request

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

Headers:

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

Body:

{
  "action": "update_fandata",
  "data": {
    "cpf": "12345678900",
    "id": "internal_feng_id"
  }
}

Body Fields

Field	Type	Required	Description
cpf	string/null	No	User's CPF (can be null)
id	string	Yes	Internal ID from source system

Success Response

Status: 201 Created

{
  "id": "uuid-of-object",
  "created": "2025-01-01T00:00:00Z",
  "iCode": 0,
  "iMsg": "Object created successfully",
  "processDate": null,
  "processStatus": "pending",
  "processMsg": null
}

Check Processing

Request

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

Headers:

AccessToken: {access_token}

Success Response

Status: 200 OK

{
  "id": "uuid-of-object",
  "created": "2025-01-01T00:00:00Z",
  "iCode": 0,
  "iMsg": "Processed successfully",
  "processDate": "2025-01-01T00:05:00Z",
  "processStatus": "completed",
  "processMsg": "Data updated successfully"
}

Implementation Example

async function updateFandata(data, 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: data
    })
  });

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

  return await response.json();
}