> ## 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.

# Pixel de Rastreamento

> Pixel de rastreamento para monitorar abertura de emails

## Descrição

Pixel de rastreamento para monitorar abertura de emails. Retorna uma imagem transparente 1x1 e registra a leitura em background.

## Query Parameters

<ParamField query="email" type="string" required>
  Email do leitor
</ParamField>

<ParamField query="id" type="string" required>
  ID do post ou email
</ParamField>

<ParamField query="utm_source" type="string">
  Fonte UTM para tracking
</ParamField>

<ParamField query="utm_medium" type="string">
  Meio UTM para tracking
</ParamField>

<ParamField query="utm_campaign" type="string">
  Campanha UTM para tracking
</ParamField>

<ParamField query="utm_channel" type="string">
  Canal UTM para tracking
</ParamField>

<ParamField query="state" type="string">
  Estado adicional para tracking
</ParamField>

## Response

Retorna uma imagem PNG transparente de 1x1 pixel com headers de cache agressivo.

### Headers de Resposta

* `Content-Type`: image/png
* `Cache-Control`: public, max-age=31536000, immutable
* `ETag`: Baseado nos parâmetros da requisição

<RequestExample>
  ```bash theme={null}
  curl --request GET \
    --url 'https://backend.testeswaffle.org/streaks/pixel?email=leitor@exemplo.com&id=post_123&utm_source=newsletter&utm_medium=email'
  ```
</RequestExample>

<ResponseExample>
  ```
  [Imagem PNG transparente 1x1]

  Headers:
  Content-Type: image/png
  Cache-Control: public, max-age=31536000, immutable
  ETag: "W/abc123xyz"
  ```
</ResponseExample>

## Notas

* O pixel executa o registro da leitura de forma assíncrona
* Implementa cache agressivo para otimizar performance
* Usado principalmente em emails para tracking de abertura


## OpenAPI

````yaml GET /streaks/pixel
openapi: 3.1.0
info:
  title: Streaks API
  description: API para gerenciamento de streaks e gamificação de leitura do the news
  version: 1.0.0
servers:
  - url: https://backend.testeswaffle.org
security:
  - bearerAuth: []
paths:
  /streaks/pixel:
    get:
      tags:
        - Tracking
      summary: Pixel de Rastreamento
      description: Pixel de rastreamento para monitorar abertura de emails
      parameters:
        - name: email
          in: query
          required: true
          schema:
            type: string
            format: email
          description: Email do leitor
        - name: id
          in: query
          required: true
          schema:
            type: string
          description: ID do post ou email
        - name: utm_source
          in: query
          schema:
            type: string
          description: Fonte UTM
        - name: utm_medium
          in: query
          schema:
            type: string
          description: Meio UTM
        - name: utm_campaign
          in: query
          schema:
            type: string
          description: Campanha UTM
        - name: utm_channel
          in: query
          schema:
            type: string
          description: Canal UTM
        - name: state
          in: query
          schema:
            type: string
          description: Estado adicional
      responses:
        '200':
          description: Pixel transparente 1x1
          content:
            image/png:
              schema:
                type: string
                format: binary
      security: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````