Registrar Leitura

curl --request POST \
  --url https://backend.testeswaffle.org/streaks/read \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "postId": "post_123456",
    "utm_source": "newsletter",
    "utm_medium": "email",
    "utm_campaign": "daily_news"
  }'

curl --request POST \
  --url https://backend.testeswaffle.org/streaks/read \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "postUrl": "https://thenewscc.beehiiv.com/p/minha-newsletter",
    "utm_source": "newsletter",
    "utm_medium": "email",
    "utm_campaign": "daily_news"
  }'

curl --request POST \
  --url https://backend.testeswaffle.org/streaks/read \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

{
  "success": true,
  "message": "Leitura registrada com sucesso",
  "data": {
    "readerId": "reader_789",
    "currentStreak": 7,
    "maxStreak": 15,
    "readToday": true
  }
}

{
  "success": true,
  "message": "Streak recalculado com sucesso.",
  "data": {
    "readerId": "reader_789",
    "currentStreak": 7,
    "maxStreak": 15,
    "readToday": true
  }
}

{
  "success": false,
  "message": "Post não encontrado para a URL informada."
}

POST

streaks

read

curl --request POST \
  --url https://backend.testeswaffle.org/streaks/read \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "postId": "post_123456",
    "utm_source": "newsletter",
    "utm_medium": "email",
    "utm_campaign": "daily_news"
  }'

curl --request POST \
  --url https://backend.testeswaffle.org/streaks/read \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "postUrl": "https://thenewscc.beehiiv.com/p/minha-newsletter",
    "utm_source": "newsletter",
    "utm_medium": "email",
    "utm_campaign": "daily_news"
  }'

curl --request POST \
  --url https://backend.testeswaffle.org/streaks/read \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

{
  "success": true,
  "message": "Leitura registrada com sucesso",
  "data": {
    "readerId": "reader_789",
    "currentStreak": 7,
    "maxStreak": 15,
    "readToday": true
  }
}

{
  "success": true,
  "message": "Streak recalculado com sucesso.",
  "data": {
    "readerId": "reader_789",
    "currentStreak": 7,
    "maxStreak": 15,
    "readToday": true
  }
}

{
  "success": false,
  "message": "Post não encontrado para a URL informada."
}

Descrição

Registra uma nova leitura de conteúdo para um usuário, atualizando seu streak. O post pode ser identificado pelo postId ou pela postUrl. Se nenhum dos dois for fornecido, o endpoint apenas recalcula o streak do usuário sem registrar uma nova leitura.

Autenticação

Requer autenticação. O email do leitor é obtido automaticamente do token JWT. Não é necessário enviar o email no body da requisição.

Authorization

string

required

Token JWT no formato Bearer <token>

Request Body

postId

string

ID do post lido. Opcional se postUrl for fornecido.

postUrl

string

URL do post lido. Alternativa ao postId - o sistema buscará o post correspondente pela URL no banco de dados. Opcional se postId for fornecido.

utm_source

string

Fonte UTM para tracking

utm_medium

string

Meio UTM para tracking

utm_campaign

string

Campanha UTM para tracking

Identificação do Post: Forneça postId OU postUrl. Se ambos forem fornecidos, o postId terá prioridade. Se nenhum for fornecido, o endpoint apenas recalculará o streak do usuário.

Response

success

boolean

Indica se a operação foi bem-sucedida

message

string

Mensagem informativa sobre o resultado

data

object

Show properties

readerId

string

ID único do leitor

currentStreak

number

Streak atual do usuário

maxStreak

number

Maior streak já alcançado pelo usuário

readToday

boolean

Indica se o usuário já leu hoje

Exemplos de Uso