cURL

Comandos diretos para terminal. Bom para testar uma chave nova ou debugar resposta em produção.

Variável de ambiente

Defina a chave uma única vez no shell para reaproveitar nos exemplos.

export SR_KEY="sr_live_sua_chave_aqui"

Rastreamento

curl -H "Authorization: Bearer $SR_KEY" \
  "https://seurastreio.com.br/api/public/rastreio/BR123456789BR"

Rastreamento Total Express

curl -H "Authorization: Bearer $SR_KEY" \
  "https://seurastreio.com.br/api/public/rastreio/TXAQ187563341tx"

Consulta de CEP

curl -H "Authorization: Bearer $SR_KEY" \
  "https://seurastreio.com.br/api/public/cep/01310100"

Listar credenciais Correios LR

curl -H "Authorization: Bearer $SR_KEY" \
  "https://seurastreio.com.br/api/public/logistica-reversa/credenciais"

Criar Logística Reversa

curl -X POST "https://seurastreio.com.br/api/public/logistica-reversa" \
  -H "Authorization: Bearer $SR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "credentialId": "9a2c1f80-1234-4abc-9def-000000000001",
    "tipo": "A",
    "servicoEnvio": "pac",
    "remetente": {
      "nome": "Maria Silva",
      "logradouro": "Rua das Flores",
      "numero": "100",
      "complemento": "",
      "bairro": "Centro",
      "cidade": "São Paulo",
      "uf": "SP",
      "cep": "01310100",
      "ddd": "11",
      "telefone": "987654321",
      "email": "[email protected]"
    }
  }'

Listar Logísticas Reversas

curl -H "Authorization: Bearer $SR_KEY" \
  "https://seurastreio.com.br/api/public/logistica-reversa?limit=20"

Próxima página (com cursor)

curl -H "Authorization: Bearer $SR_KEY" \
  "https://seurastreio.com.br/api/public/logistica-reversa?limit=20&cursor=lr_uuid_da_ultima"

Consultar LR específica

curl -H "Authorization: Bearer $SR_KEY" \
  "https://seurastreio.com.br/api/public/logistica-reversa/lr_uuid_interno"

Dicas úteis

Resposta formatada com jq

curl -s -H "Authorization: Bearer $SR_KEY" \
  "https://seurastreio.com.br/api/public/cep/01310100" | jq

Ver headers (debug de cache)

curl -i -H "Authorization: Bearer $SR_KEY" \
  "https://seurastreio.com.br/api/public/rastreio/BR123456789BR"

Apenas o status code

curl -o /dev/null -s -w "%{http_code}\n" \
  -H "Authorization: Bearer $SR_KEY" \
  "https://seurastreio.com.br/api/public/rastreio/INVALID"
Em Windows/PowerShell troque $SR_KEY por $env:SR_KEY e use curl.exe (não o alias curl que aponta para Invoke-WebRequest).