Documentação da API - Virtual SMS

Voltar ao início

Solicitar Número

Essa requisição permite que você solicite um número virtual para uso. Basta enviar a requisição com os parâmetros adequados.

<?php
$apiKey = 'SUA_API_KEY';
$serviceId = 'ID_DO_SERVIÇO';

$url = "https://brasilnumeros.com/api-c/compra.php?api_key=$apiKey";

$data = [
    'service_id' => $serviceId
];

// Inicializa cURL
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);

if (curl_errno($ch)) {
    echo "Erro na requisição: " . curl_error($ch);
} else {
    if ($httpCode === 200) {
        $responseData = json_decode($response, true);
        if (json_last_error() === JSON_ERROR_NONE) {
            print_r($responseData);
        } else {
            echo "Erro ao decodificar JSON: " . json_last_error_msg();
        }
    } else {
        echo "Erro HTTP: $httpCode\nResposta: $response";
    }
}
curl_close($ch);
?>
import requests

data = {
    'service_id': 'ID DO SERVIÇO'  # Parâmetro POST
}

api_key = 'SUA API KEY'  # Parâmetro GET
url = f'https://brasilnumeros.com/api-c/compra.php?api_key={api_key}'

response = requests.post(url, data=data)
try:
    print(response.json())  # Para exibir o JSON recebido
except Exception as e:
    print(f"Erro ao processar resposta: {e}")
    print(response.text)  # Exibir o conteúdo da resposta

const axios = require('axios');

const apiKey = 'SUA_API_KEY';
const serviceId = 'ID_DO_SERVIÇO';

const url = `https://brasilnumeros.com/api-c/compra.php?api_key=${apiKey}`;

axios.post(url, {
    service_id: serviceId
})
.then(response => {
    console.log(response.data);
})
.catch(error => {
    if (error.response) {
        console.error('Erro na resposta:', error.response.status, error.response.data);
    } else if (error.request) {
        console.error('Erro na requisição:', error.request);
    } else {
        console.error('Erro desconhecido:', error.message);
    }
});

Cancelar Número

Use essa requisição para cancelar um número que foi solicitado anteriormente.

<?php
$url = "https://brasilnumeros.com/api-c/cancelar.php";
$apiKey = "02301E20984F8D93"; // Substitua pela sua chave API
$idCompra = 11433; // Substitua pelo ID da compra que deseja cancelar

// Dados que serão enviados via POST
$data = [
    'api_key' => $apiKey,
    'id_compra' => $idCompra
];

// Iniciando o cURL
$ch = curl_init($url);

// Configurando a requisição POST
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); // Para receber a resposta
curl_setopt($ch, CURLOPT_TIMEOUT, 30); // Timeout opcional

// Executa a requisição
$response = curl_exec($ch);

// Verifica se houve erro na requisição
if (curl_errno($ch)) {
    echo "Erro na requisição: " . curl_error($ch);
} else {
    $httpStatus = curl_getinfo($ch, CURLINFO_HTTP_CODE);

    if ($httpStatus === 200) {
        $responseData = json_decode($response, true);

        if (json_last_error() === JSON_ERROR_NONE) {
            echo "Resposta da API: " . print_r($responseData, true);
        } else {
            echo "Erro ao decodificar JSON: " . json_last_error_msg();
            echo "Resposta bruta: " . $response;
        }
    } else {
        echo "Erro na resposta. Código de status: $httpStatus\nResposta: $response";
    }
}

// Fecha a conexão cURL
curl_close($ch);
?>

import requests

# URL da API de cancelamento de número
url = "https://brasilnumeros.com/api-c/cancelar.php"

# Parâmetros necessários
api_key = "SUA API KEY"  # Substitua pela sua chave API
id_compra = 12345  # Substitua pelo ID da compra que deseja cancelar

# Dados que serão enviados via POST
data = {
    'api_key': api_key,
    'id_compra': id_compra
}

try:
    # Enviando a solicitação POST
    response = requests.post(url, data=data)

    # Verificando o status da resposta
    if response.status_code == 200:
        response_json = response.json()
        print("Resposta da API:", response_json)
    else:
        print(f"Erro ao conectar à API. Código de status: {response.status_code}")
        print("Resposta:", response.text)

except requests.exceptions.RequestException as e:
    print(f"Erro ao conectar: {e}")

const axios = require('axios');

const url = "https://brasilnumeros.com/api-c/cancelar.php";
const apiKey = "02301E20984F8D93";  // Substitua pela sua chave API
const idCompra = 11433;  // Substitua pelo ID da compra que deseja cancelar

axios.post(url, {
    api_key: apiKey,
    id_compra: idCompra
})
.then(response => {
    console.log("Resposta da API:", response.data);
})
.catch(error => {
    if (error.response) {
        console.error("Erro na resposta:", error.response.status, error.response.data);
    } else {
        console.error("Erro na requisição:", error.message);
    }
});

Informações de Serviços

Essa requisição permite que você obtenha informações sobre os serviços disponíveis na API.

<?php
// URL da API de informações de serviços
$url = "https://brasilnumeros.com/api-c/servicos.php";

// Dados da requisição
$api_key = "SUA_CHAVE_API";  // Substitua pela sua chave API

// Array de dados a serem enviados
$data = array(
    'api_key' => $api_key
);

// Configurar a requisição cURL
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// Executar a requisição
$response = curl_exec($ch);

// Verificar por erros
if ($response === false) {
    echo 'Erro na requisição: ' . curl_error($ch);
} else {
    // Decodificar e exibir a resposta da API
    $responseData = json_decode($response, true);
    echo "Resposta da API: ";
    print_r($responseData);
}

// Fechar a conexão cURL
curl_close($ch);
?>
import requests

# URL da API de informações de serviços
url = 'https://brasilnumeros.com/api-c/servicos.php'

# Dados da requisição
data = {
    'api_key': 'SUA_CHAVE_API',  # Substitua pela sua chave API
}

# Enviar a requisição POST
response = requests.post(url, data=data)

# Verificar se a requisição foi bem-sucedida
if response.status_code == 200:
    try:
        # Decodificar a resposta em JSON
        response_data = response.json()
        print('Resposta da API:', response_data)
    except ValueError:
        print('Erro ao decodificar a resposta JSON:', response.text)
else:
    print(f'Erro na requisição. Código de status: {response.status_code}')
const axios = require('axios');

// URL da API de informações de serviços
const url = 'https://brasilnumeros.com/api-c/servicos.php';

// Dados da requisição
const data = {
    api_key: 'SUA_CHAVE_API',  // Substitua pela sua chave API
};

// Enviar a requisição POST
axios.post(url, data)
    .then(response => {
        console.log('Resposta da API:', response.data);
    })
    .catch(error => {
        console.error('Erro ao conectar à API:', error.response ? error.response.data : error.message);
    });

Solicitar Código

Use essa requisição para solicitar o código para um serviço solicitado.

<?php

$url = "https://brasilnumeros.com/api-c/verificar_codigo.php";
$api_key = "SUA API KEY";  // Substitua pela sua chave API
$id_compra = 12345;  // Substitua pelo ID da compra

// Dados para enviar via POST
$data = [
    'api_key' => $api_key,
    'id_compra' => $id_compra
];

// Inicializar cURL
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$http_status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($http_status === 200) {
    $response_json = json_decode($response, true);
    echo "Resposta da API: ";
    print_r($response_json);

    // Registrar a resposta no log.txt
    file_put_contents("log.txt", "Resposta da API: " . print_r($response_json, true) . PHP_EOL, FILE_APPEND);
} else {
    echo "Erro ao conectar à API. Código de status: $http_status\n";
    echo "Resposta: $response";
}

?>

import requests

url = "https://brasilnumeros.com/api-c/verificar_codigo.php"
api_key = "SUA API KEY"  # Substitua pela sua chave API
id_compra = 12345  # Substitua pelo ID da compra que deseja consultar

# Dados que serão enviados via POST
data = {
    'api_key': api_key,
    'id_compra': id_compra
}

try:
    # Enviando a solicitação POST
    response = requests.post(url, data=data)

    # Verificando o status da resposta
    if response.status_code == 200:
        response_json = response.json()
        print("Resposta da API:", response_json)

        # Registrar a resposta no log.txt
        with open("log.txt", "a") as log_file:
            log_file.write(f"Resposta da API: {response_json}\n")

    else:
        print(f"Erro ao conectar à API. Código de status: {response.status_code}")
        print("Resposta:", response.text)

except requests.exceptions.RequestException as e:
    print(f"Erro ao conectar: {e}")

const axios = require('axios');
const fs = require('fs');

const url = "https://brasilnumeros.com/api-c/verificar_codigo.php";
const apiKey = "SUA API KEY";  // Substitua pela sua chave API
const idCompra = 12345;  // Substitua pelo ID da compra

// Dados para enviar via POST
const data = {
    api_key: apiKey,
    id_compra: idCompra
};

axios.post(url, data)
    .then(response => {
        console.log("Resposta da API:", response.data);

        // Registrar a resposta no log.txt
        fs.appendFileSync("log.txt", `Resposta da API: ${JSON.stringify(response.data)}\n`, 'utf8');
    })
    .catch(error => {
        if (error.response) {
            console.error(`Erro ao conectar à API. Código de status: ${error.response.status}`);
            console.error("Resposta:", error.response.data);
        } else {
            console.error("Erro na requisição:", error.message);
        }
    });