POST
/
tools
/
api
/
manual-update
cURL
curl --request POST \
  --url https://pierre.finance/tools/api/manual-update \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "message": "Manual sync initiated",
  "connectedAccounts": 3,
  "note": "The sync process will run in the background. Check your dashboard for updates.",
  "timestamp": "2024-01-15T10:30:00Z"
}
Este endpoint força uma sincronização manual dos dados financeiros.

​
Descrição

O endpoint POST /tools/api/manual-update força uma sincronização manual de todos os dados financeiros conectados, buscando as informações mais recentes das instituições financeiras.

​
Autenticação

Este endpoint requer autenticação via Bearer token.
​
Authorization
string
required
Bearer token com a API key do usuário. Formato: Bearer sk-your-api-key-here

​
Corpo da Requisição

Este endpoint não requer corpo de requisição.

​
Resposta

​
Sucesso (200)

{
  "success": true,
  "message": "Manual sync initiated",
  "connectedAccounts": 3,
  "note": "The sync process will run in the background. Check your dashboard for updates.",
  "timestamp": "2024-01-15T10:30:00Z"
}

​
Erro - Sem Contas Conectadas (400)

{
  "error": "No connected accounts found",
  "message": "Please connect your financial accounts first",
  "nextSteps": [
    "Visit https://pierre.finance to connect your accounts",
    "Contact support if you need assistance"
  ]
}

​
Erro de Autenticação (401)

{
  "error": "Invalid or inactive API key",
  "message": "Please check your API key and try again",
  "type": "invalid_api_key"
}

​
Campos da Resposta

​
success
boolean
required
Indica se a requisição foi bem-sucedida
​
message
string
required
Mensagem de confirmação da sincronização
​
connectedAccounts
number
required
Número de contas conectadas que serão sincronizadas
​
note
string
required
Nota informativa sobre o processo de sincronização
​
timestamp
string
required
Timestamp da requisição em formato ISO 8601

​
Exemplos de Uso

​
cURL

# Forçar sincronização manual
curl -X POST 'https://pierre.finance/tools/api/manual-update' \
  -H 'Authorization: Bearer sk-your-api-key-here'

​
JavaScript

const API_KEY = 'sk-your-api-key-here';
const BASE_URL = 'https://pierre.finance/tools/api';

async function manualUpdate() {
  const response = await fetch(`${BASE_URL}/manual-update`, {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${API_KEY}`,
      'Content-Type': 'application/json'
    }
  });
  
  return await response.json();
}

// Uso
manualUpdate().then(result => {
  console.log('Sincronização iniciada:', result.message);
});

​
Python

import requests

API_KEY = 'sk-your-api-key-here'
BASE_URL = 'https://pierre.finance/tools/api'

headers = {
    'Authorization': f'Bearer {API_KEY}',
    'Content-Type': 'application/json'
}

def manual_update():
    response = requests.post(f'{BASE_URL}/manual-update', headers=headers)
    return response.json()

# Uso
result = manual_update()
print('Sincronização iniciada:', result['message'])

​
Códigos de Status

  • 200: Sucesso - Sincronização iniciada
  • 400: Erro - Nenhuma conta conectada encontrada
  • 401: Erro de autenticação ou assinatura
  • 500: Erro interno do servidor

​
Quando Usar

Execute este endpoint quando:
  • O usuário pedir para “atualizar meus dados”
  • O usuário pedir para “sincronizar minhas contas”
  • O usuário mencionar que os dados parecem desatualizados
  • O usuário pedir sobre transações recentes que não aparecem
  • O usuário quiser garantir que tem as informações mais atuais
  • O usuário reportar problemas com dados incompletos ou desatualizados
A sincronização manual pode levar alguns minutos para ser concluída. Os dados serão atualizados em background.
Este endpoint é especialmente útil quando você precisa garantir que tem os dados mais recentes das instituições financeiras.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

Sincronização iniciada

The response is of type object.