Clean Store DEVELOPER API

Integre sua infraestrutura ao seu e-mail temporário.

Crie caixas, consulte mensagens e use o serviço de números temporários para receber SMS.

Autenticação

Gere uma chave em POST /api/keys e envie-a como x-api-key. Depois autentique a caixa e use o token retornado como Bearer token.

POST /api/token
Content-Type: application/json
x-api-key: SUA_CHAVE_DE_API

{
  "address": "sua-caixa@dominio.com",
  "password": "sua-senha"
}

Consultar mensagens

GET /api/messages
x-api-key: SUA_CHAVE_DE_API
Authorization: Bearer TOKEN_DE_SESSAO
x-temp-email: sua-caixa@dominio.com

SMS Virtual

O catálogo público retorna os países, serviços, disponibilidade e preços atuais para números temporários.

GET /api/sms/countries
GET /api/sms/products?country=brazil

Para habilitar reservas pela interface, configure as credenciais privadas e SMS_PUBLIC_PURCHASES_ENABLED=true somente no servidor. O usuário não informa nenhuma chave. Envie em expectedPrice o preço atual do catálogo; a API recusa a reserva se o preço mudar ou o serviço ficar sem estoque.

POST /api/sms/orders
Content-Type: application/json

{
  "country": "brazil",
  "operator": "any",
  "product": "telegram",
  "expectedPrice": 1.25
}

GET /api/sms/orders/ID_DO_PEDIDO
x-sms-order-token: TOKEN_RETORNADO_NA_RESERVA

POST /api/sms/orders/ID_DO_PEDIDO/cancel
x-sms-order-token: TOKEN_RETORNADO_NA_RESERVA

Recursos

Mantenha chaves, senhas e tokens no backend da sua aplicação. Não publique credenciais em código frontend ou páginas indexáveis.