Endpoints

Endpoints

Parâmetros

Parameters

Exemplo

Example

curl https://api.alicercelabs.com.br/api/v1/registrobr/brasilapi.com.br \
          -H "Authorization: Bearer <token>"

{
          "success": true,
          "data": {
            "dominio": "brasilapi.com.br",
            "disponivel": false,
            "status": ["active"],
            "registrado_em": "2016-09-24T02:14:52Z",
            "expira_em": "2028-09-24T02:14:52Z",
            "nameservers": ["bob.ns.cloudflare.com", "lily.ns.cloudflare.com"],
            "meta": { "fonte": "registro.br" }
          },
          "meta": { "elapsed_ms": 180, "request_id": "..." }
        }

Erros possíveis

Possible errors

Duas fontes

Two sources

Primeiro o RDAP do Registro.br (RFC 9083), protocolo público padronizado, sem chave — mesmo protocolo que a API de IP já usa pra IP/ASN, só que aqui é um cliente à parte porque domínio .br sempre vai pro mesmo servidor, sem bootstrap de rede pra descobrir qual RIR consultar. Um domínio disponível dá 404 no RDAP — isso não é erro, é resposta válida (disponivel: true). Se o RDAP falhar por erro de rede, a chamada cai pra BrasilAPI.

First, Registro.br's RDAP (RFC 9083), a standardized public protocol, no key — the same protocol the IP API already uses for IP/ASN, just a separate client here because a .br domain always goes to the same server, no network bootstrap needed to figure out which RIR to query. An available domain returns 404 from RDAP — that's not an error, it's a valid answer (disponivel: true). If RDAP fails with a network error, the call falls through to BrasilAPI.

Usando o SDK

Using the SDK

SDKs oficiais: Go · Python · JavaScript.

Official SDKs: Go · Python · JavaScript.

Avaliar um domínio

Evaluate a domain

import (
	"context"
	"fmt"

	alicercelabs "github.com/alicercelabs/alicercesdk-go"
)

client := alicercelabs.New("alk_...") // ou um token JWT de login/register
ctx := context.Background()

resultado, err := client.RegistroBR.Get(ctx, "brasilapi.com.br")
if err != nil {
	panic(err)
}
fmt.Println(resultado.Disponivel)

from alicercelabs import AlicerceLabs

client = AlicerceLabs(api_key="alk_...")  # ou um token JWT de login/register

resultado = client.registrobr.get("brasilapi.com.br")
print(resultado["disponivel"])

import { AlicerceLabs } from "alicercesdk-javascript";

const client = new AlicerceLabs("alk_..."); // ou um token JWT de login/register

const resultado = await client.registroBR.get("brasilapi.com.br");
console.log(resultado.disponivel);

Limites

Limits

100/dia · 4/hora sem token, por IP chamador; com token (JWT de login ou API key gerada no painel), 1.000/dia · 41/hora. Resposta em cache por 1h.

100/day · 4/hour without a token, per calling IP; with one (a login JWT or an API key generated in the panel), 1,000/day · 41/hour. Response cached for 1h.