> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thenewscc.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Atualizar Dados de Fraude

> Atualiza dados de fraude ausentes em indicações antigas

## Descrição

Atualiza dados de fraude ausentes em indicações antigas. Este endpoint tem um timeout de 30 minutos devido ao processamento extensivo. É público mas deve ser usado apenas quando necessário.  **Requer autenticação JWT**.

## Request Body

<ParamField body="batch_size" type="number" default="100">
  Tamanho do lote para processamento
</ParamField>

<ParamField body="start_date" type="string">
  Data inicial para processar indicações (formato YYYY-MM-DD)
</ParamField>

<ParamField body="end_date" type="string">
  Data final para processar indicações (formato YYYY-MM-DD)
</ParamField>

## Response

<ResponseField name="success" type="boolean">
  Indica se a operação foi bem-sucedida
</ResponseField>

<ResponseField name="data" type="object">
  <Expandable title="properties">
    <ResponseField name="processed" type="number">
      Número de indicações processadas
    </ResponseField>

    <ResponseField name="updated" type="number">
      Número de indicações atualizadas com novos dados de fraude
    </ResponseField>

    <ResponseField name="fraud_detected" type="number">
      Número de indicações com fraude detectada
    </ResponseField>

    <ResponseField name="processing_time" type="string">
      Tempo total de processamento
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash theme={null}
  curl --request POST \
    --url https://backend.testeswaffle.org/referrals/update-fraud \
    --header 'Content-Type: application/json' \
    --data '{
      "batch_size": 500,
      "start_date": "2024-01-01",
      "end_date": "2024-01-31"
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "success": true,
    "data": {
      "processed": 1250,
      "updated": 876,
      "fraud_detected": 42,
      "processing_time": "12m 34s"
    }
  }
  ```
</ResponseExample>

## Notas

* Este endpoint tem timeout de 30 minutos
* Processa indicações em lotes para otimizar performance
* Recomendado executar em horários de baixo tráfego
* Pode ser necessário executar múltiplas vezes para grandes volumes


## OpenAPI

````yaml POST /referrals/update-fraud
openapi: 3.1.0
info:
  title: Referrals API
  description: API para gerenciamento do programa de indicações do the news
  version: 1.0.0
servers:
  - url: https://backend.testeswaffle.org
security:
  - bearerAuth: []
paths:
  /referrals/update-fraud:
    post:
      tags:
        - Public
      summary: Atualizar Dados de Fraude
      description: Atualiza dados de fraude ausentes em indicações antigas
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                batch_size:
                  type: number
                  default: 100
                  description: Tamanho do lote
                start_date:
                  type: string
                  format: date
                  description: Data inicial (YYYY-MM-DD)
                end_date:
                  type: string
                  format: date
                  description: Data final (YYYY-MM-DD)
      responses:
        '200':
          description: Resultado do processamento
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  data:
                    type: object
                    properties:
                      processed:
                        type: number
                      updated:
                        type: number
                      fraud_detected:
                        type: number
                      processing_time:
                        type: string
      security: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````