Documentação da API10% OFF!

Nossa API (Application Programming Interface) é totalmente compatível com o protocolo universal padrão de mercado de SMS. Isso significa que você pode integrar o BrazucaSMS facilmente em qualquer software, painel SMM ou robô de automação que suporte esse padrão, sem a necessidade de reescrever códigos complexos!

🔥 Benefício: Todos os pedidos feitos através da API recebem um desconto automático de 10% sobre o valor exibido no site! Integre agora e aumente a sua margem de lucro.

1. URL Base & Autenticação

Todos os pedidos (suporte a GET e POST) devem ser direcionados para a nossa URL Base. É obrigatório enviar a sua chave secreta no parâmetro api_key.

https://brazucasms.com/api/external

Como conseguir sua chave de API?

Acesse a aba de Perfil aqui no site para gerar sua chave secreta. Mantenha-a em sigilo absoluto!

Acessar Perfil

2. Erros Comuns

Ao fazer uma requisição, o servidor pode retornar um erro genérico. Prepare seu sistema para tratá-los:

Resposta do Servidor	Descrição
BAD_KEY	A chave de API informada é inválida ou foi revogada.
NO_BALANCE	A sua conta não tem saldo suficiente para realizar esta ação.
BAD_ACTION	Ação inválida ou parâmetros obrigatórios ausentes na URL.
BAD_OPERATOR	A operadora especificada não é suportada ou é inválida.
ERROR_SQL	Erro interno de banco de dados. Tente novamente mais tarde.

3. Endpoints de Ação

GET

Consultar Saldo (getBalance)

?api_key=SUA_CHAVE&action=getBalance

Retorna o saldo atualizado da sua conta para compras na API.

Exemplo de Sucesso: ACCESS_BALANCE:150.50

GET

Tabela de Preços (getPrices)

?api_key=SUA_CHAVE&action=getPrices&country=73

Retorna um JSON listando a quantidade de números em estoque e o custo unitário por serviço.

Exemplo de Sucesso:

{"73": {"cq": {"server1": {"cost": 3.5, "count": 1500}, "server2": {"cost": 4.0, "count": 500}, "server3": {"cost": 2.5, "count": 800}, "server4": {"cost": 3.0, "count": 200}, "server5": {"cost": 3.5, "count": 50}, "server6": {"cost": 3.2, "count": 300}}, "ev": {"server1": {"cost": 2.0, "count": 340}}}}

GET

Solicitar Número (getNumber)

?api_key=SUA_CHAVE&action=getNumber&service=cq&operator=any&country=73

Parâmetro	Obrigatório	Descrição
service	Sim	Código do serviço (ex: `cq`, `ev`)
operator	Não	Use `any` para rota automática (mais barato) ou especifique o servidor desejado (ex: `server1`, `server2`, `server3`, `server4`, `server5`, `server6`). Dica de Qualidade: Disponibilizamos múltiplos servidores para garantir a melhor taxa de entrega. O `server3` foca em custo-benefício, enquanto `server4`, `server5` e `server6` (HeroSMS) possuem rotas alternativas premium de alta confiabilidade. Teste qual se adapta melhor ao seu serviço!
country	Não	Código do país (ex: `73` para Brasil).

Exemplo de Sucesso: ACCESS_NUMBER:9876543:5511999999999 (ID : Número com DDI)Erros Específicos: NO_NUMBERS (Estoque esgotado), WRONG_SERVICE (Serviço inválido)

GET

Reativar Número (getExtraActivation)

?api_key=SUA_CHAVE&action=getExtraActivation&activationId=ID_DA_ATIVACAO_ANTIGA

Solicita a reativação de um número antigo (que já foi finalizado) para receber um novo SMS.

Atenção: A função de reativação é suportada APENAS pelo server2. Nos outros servidores, o pedido retornará falha.Exemplo de Sucesso: ACCESS_NUMBER:NOVO_ID:NUMEROErros Específicos: NO_NUMBERS (Não foi possível reativar o número), NO_ACTIVATION (ID não encontrado)

GET

Consultar SMS (getStatus)

?api_key=SUA_CHAVE&action=getStatus&id=ID_DA_ATIVACAO

Utilize este comando em loop (a cada 5-10 segundos) para verificar se o SMS chegou na operadora.

Aguardando: STATUS_WAIT_CODESucesso: STATUS_OK:654321 (Onde 654321 é o SMS recebido)Cancelado: STATUS_CANCEL

GET

Gerenciar Status (setStatus)

?api_key=SUA_CHAVE&action=setStatus&id=ID_DA_ATIVACAO&status=STATUS_ID

Envia um comando para a operadora (Cancelar ou Solicitar Reenvio).

Status	Ação Executada
8	Cancelar Ativação. Devolve imediatamente o valor integral para o seu saldo e finaliza o número. Retorno esperado: `ACCESS_CANCEL`.
3	Solicitar novo SMS. Avisa a operadora que você precisa de mais um SMS para o mesmo número (ex: verificação dupla). Retorno esperado: `ACCESS_RETRY_GET`. Atenção: A disponibilidade de um segundo SMS não é garantida e depende da operadora do servidor escolhido.

4. Lista de Serviços Disponíveis

Abaixo está a lista completa dos códigos dos serviços suportados pela nossa API (exclusivos para integração). Os serviços de WhatsApp e Telegram foram omitidos desta lista por estarem restritos.

99 APPki

Acmeacme

Agibanksa

Aiqfomebbi

AirBnbuk

Alibabaab

AliExpresshx

Alipay/Alibabahw

Amazonam

AOLpm

Aposta Ganhaml

Applewx

ASAASbqr

Astropaygr

Autodeskbbl

Baiduli

Banqivc

BeBooabd

Bet365ie

Big Cashbzb

Bigo Livebl

Bilibilizs

Bipabaj

Bitsoht

BlaBlaCarua

Blizzardbz

Br777jw

Bradescoann

Brahmasy

BrDoublebrdou

Budweiserzt

Bumblemo

BVavy

C6 Bankaff

Caixamy

Careemls

Carousellgj

Casinopc

Celcoinix

Clubhouseet

Coinbasere

Coronaom

Craigslistwc

CrefisaMaisax

Cruzeiroccl

CupidMediaaje

Dakiahi

Deliveroozk

DiDi Taxixk

Discordds

Disneyud

DocuSignblr

Dotzcj

Dotzxj

Ebaydh

Efíbzw

Efí Bankefi

Enebauf

Enjoeiarf

EToroapb

Etsyetsy

Facebookfb

Facilyalc

Familhaoasl

FastEarnany

Feeldse

Firebaseaim

Fiverrcn

Foodpandanz

Fruitzmv

G2Gbk

GalaxyChatxe

Gappxarg

Getirul

GetNinjasaiu

GiraBankjd

GoChatads

Googlego

Google Chatccu

Google Chatght

GoogleMessengergmsg

GoogleVoicegf

GovBrafe

Grindryw

Guiche Webalb

GuruBetsik

Guviguv

Happndf

Hingevz

Huarenjiehrnjie

Icqiq

IFoodpd

IMO Messengerim

InDriverrl

InfinitePayanx

Instagramig

IQOSil

Itaubtn

Itiad

Jingdongza

Joyridexx

Justdatingpu

K8Betk8bet

KakaoTalkkt

KeyPayra

Kliqkiq

Kwaivp

Lalamovefh

Lazadadl

Leboncoindo

Line Msgme

LinkedIntn

Lucky Playlucky

LUUPbeh

MagaLuafq

Mambafd

Manusbwv

Meliuzuy

Mercadocq

MeSeemsamv

MiChatmc

Microsoftmm

Mocospacegm

Monzoaom

MoonPaybgj

Ñ Me Perturbeaxm

Namarsabn

Natura Avonawg

Navernv

Neonaex

Netflixnf

Nextaey

NgCashawh

Nikeew

Noontf

Notifirexo

Nubankaaa

Ok.ruok

Okcupidvm

OKXaor

Oldubilns

Olxsn

OpenAIdr

Otherot

Outlierauz

PagBankabg

PagSmilegg

Paparazr

Parimatchabf

Payoneernc

PayPalts

Payseraaol

Pcipaypcp

PEDIR GASbqh

PGbonusfx

Picpayev

Poeopd

Pof.compf

Potato Chatfj

Premmiaanw

Privaliaafs

Proboaa

ProtonMaildp

Quero-Q PAGbxj

Radquestayk

Rappiaba

Rebtelajj

RecargaPayxu

Reclame Aquiaoz

RedBookqf

Rei do Pitacoreip

Revolutij

Ripioavp

Santanderlj

Serasaabj

Sheinaez

ShellBoxvg

Shopeeka

Sicrediana

Signalbw

Skrillaqt

SKY VALORskyva

SkyTVpb

Smilesagb

Snapchatfu

SOOPbxz

SoulAppmx

Spatenky

Steammt

Tangoxr

Temuep

Tencent QQqq

Thingslz

Tickrb

Ticketmastergp

TikToklf

TIMtimmm

Timepassamp

Tinderoi

TotalPassauc

Twitchhb

Twittertw

Uberub

Ubisoftahb

Ultragazafr

Uolabh

Valorabdw

Vibervi

Vintedkc

Vivokx

Vk.comvk

Voltzeb

Walmartwr

Webmotorsbfa

WeChatwb

Weibokf

WestSteinth

Willbsa

Winmastersmp

WinzoGamevs

Wirexbaa

Wisebo

Wishxv

XadrezFelizfa

Xboxaml

Xiaomiyu

Yahoomb

Yallayl

Yandexya

Yemeksepetiyi

Yetz Promoyetz

YoWinsm

Zé Deliveryem

ZeeNowbtm

Zohozh