Cotar a compra de um número
Valida os requisitos da conta e calcula uma assinatura de um DID. Não cria cobrança nem reserva o número. Apresente preço, recorrência e condições de SMS ao cliente antes de criar o pedido.
Catálogo, cotação, pagamento e acompanhamento de um DID por pedido.
Base: https://novodid.com. Consulte autenticação e limites antes de executar operações.
Cotar a compra de um número
POST /api/v1/orders/quoteValida os requisitos da conta e calcula uma assinatura de um DID. Não cria cobrança nem reserva o número. Apresente preço, recorrência e condições de SMS ao cliente antes de criar o pedido.
Permissão: catalog:read
- cycle: monthly, semiannually ou yearly. paymentMethod: pix ou card. quantity, quando informado, deve ser 1.
- couponCode é opcional, com até 80 letras, números, hífen ou sublinhado.
- As confirmações de SMS não são necessárias para consultar a cotação. Na criação, confirme somente após o aceite real do cliente.
Corpo da requisição
{
"didId": 1234,
"quantity": 1,
"cycle": "monthly",
"paymentMethod": "pix",
"fixedDidSmsAcknowledged": true
}Resposta de sucesso (200)
{
"did": {
"id": 1234,
"number": "551130001234",
"kind": "fixed",
"smsEnabled": false
},
"quantity": 1,
"paymentMethod": "pix",
"pricing": {
"currency": "BRL",
"baseMonthlyAmount": 1499,
"cycle": "monthly",
"cycleMonths": 1,
"subtotalAmount": 1499,
"totalDiscountPercent": 0,
"discountedAmount": 1499,
"cardFeeAmount": 0,
"totalAmount": 1499
},
"recurring": true,
"reserved": false,
"acknowledgements": {
"fixedDidSms": {
"required": true,
"message": "Confirme que está ciente de que este número fixo não recebe SMS antes de assinar."
},
"mobileMonthlySms": {
"required": false,
"message": null
}
}
}Exemplo de erro
{
"error": {
"code": "did_unavailable",
"message": "Número indisponível para compra."
}
}curl
curl -X POST \
-H "Authorization: Bearer $NOVODID_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"didId":1234,"quantity":1,"cycle":"monthly","paymentMethod":"pix","fixedDidSmsAcknowledged":true}' \
"https://novodid.com/api/v1/orders/quote"Node
const response = await fetch("https://novodid.com/api/v1/orders/quote", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.NOVODID_API_TOKEN}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"didId": 1234,
"quantity": 1,
"cycle": "monthly",
"paymentMethod": "pix",
"fixedDidSmsAcknowledged": true
})
});
const payload = await response.json();
if (!response.ok) {
throw new Error(payload.error?.message || "Erro na API NovoDID");
}
console.log({ status: response.status });Python
import os
import requests
response = requests.post(
"https://novodid.com/api/v1/orders/quote",
headers={"Authorization": f"Bearer {os.environ['NOVODID_API_TOKEN']}"},
json={
"didId": 1234,
"quantity": 1,
"cycle": "monthly",
"paymentMethod": "pix",
"fixedDidSmsAcknowledged": True
},
timeout=30,
)
payload = response.json()
response.raise_for_status()
print({"status": response.status_code})Go
package main
import (
"fmt"
"io"
"net/http"
"os"
"strings"
)
func main() {
req, err := http.NewRequest("POST", "https://novodid.com/api/v1/orders/quote", strings.NewReader(`{"didId":1234,"quantity":1,"cycle":"monthly","paymentMethod":"pix","fixedDidSmsAcknowledged":true}`))
if err != nil {
panic(err)
}
req.Header.Set("Authorization", "Bearer "+os.Getenv("NOVODID_API_TOKEN"))
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
_, _ = io.Copy(io.Discard, res.Body)
if res.StatusCode >= 300 {
panic(fmt.Sprintf("NovoDID API HTTP %d", res.StatusCode))
}
fmt.Println(res.StatusCode)
}Rust
use serde_json::json;
use reqwest::blocking::Client;
use std::env;
fn main() -> Result<(), Box<dyn std::error::Error>> {
let client = Client::new();
let response = client
.post("https://novodid.com/api/v1/orders/quote")
.bearer_auth(env::var("NOVODID_API_TOKEN")?)
.json(&json!({
"didId": 1234,
"quantity": 1,
"cycle": "monthly",
"paymentMethod": "pix",
"fixedDidSmsAcknowledged": true
}))
.send()?;
let status = response.status();
let _payload = response.text()?;
if !status.is_success() {
return Err(format!("NovoDID API HTTP {}", status).into());
}
println!("HTTP {}", status);
Ok(())
}PHP
<?php
$ch = curl_init("https://novodid.com/api/v1/orders/quote");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer " . getenv("NOVODID_API_TOKEN"),
"Content-Type: application/json"
],
CURLOPT_POSTFIELDS => '{"didId":1234,"quantity":1,"cycle":"monthly","paymentMethod":"pix","fixedDidSmsAcknowledged":true}',
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($response === false || $status >= 300) {
throw new RuntimeException("NovoDID API HTTP " . $status);
}
echo $status . PHP_EOL;Ruby
require "net/http"
uri = URI("https://novodid.com/api/v1/orders/quote")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "Bearer #{ENV.fetch("NOVODID_API_TOKEN")}"
request["Content-Type"] = "application/json"
request.body = %q({"didId":1234,"quantity":1,"cycle":"monthly","paymentMethod":"pix","fixedDidSmsAcknowledged":true})
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
http.request(request)
end
raise "NovoDID API HTTP #{response.code}" unless response.is_a?(Net::HTTPSuccess)
puts response.codeC#
using System.Net.Http.Headers;
using System.Text;
using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Post, "https://novodid.com/api/v1/orders/quote");
request.Headers.Authorization = new AuthenticationHeaderValue(
"Bearer",
Environment.GetEnvironmentVariable("NOVODID_API_TOKEN")
);
request.Content = new StringContent(
"""
{
"didId": 1234,
"quantity": 1,
"cycle": "monthly",
"paymentMethod": "pix",
"fixedDidSmsAcknowledged": true
}
""",
Encoding.UTF8,
"application/json"
);
using var response = await client.SendAsync(request);
var payload = await response.Content.ReadAsStringAsync();
response.EnsureSuccessStatusCode();
Console.WriteLine(response.StatusCode);Consultar números à venda
Consulta o estoque disponível, excluindo números vinculados e reservados. Não reserva estoque. Consulte a cotação para validar perfil, limites e condições da conta. Valores em centavos de BRL.
Criar pagamento de um número
Cria um pedido de exatamente um DID. Pix retorna copia e cola e imagem QR; cartão retorna checkoutUrl para o cliente concluir a assinatura. Exige Idempotency-Key no cabeçalho. Criar o pedido não significa pagamento confirmado ou número ativado. HTTP 409 did_number_unavailable: não foi possível confirmar o telefone selecionado antes de criar o pagamento. Consulte o pedido indicado em error.details.orderId e atualize o catálogo antes de uma nova tentativa; não repita uma cobrança sem conferir o pedido anterior.