REGISTRO BR

Disponibilidade de domínio .br

Avalia se um domínio .br está disponível ou já registrado, via RDAP do Registro.br.

.br domain availability

Checks whether a .br domain is available or already registered, via Registro.br's RDAP.

SYNC resposta na mesma chamada answers in the same call

Endpoints

GET /api/v1/registrobr/{dominio} avalia um domínio .br evaluates a .br domain

Parâmetros

Parameters

Nome	Name	Onde	In	Descrição	Description
`dominio`	path	domínio completo (ex.: `alicercelabs.com.br`)	the full domain (e.g. `alicercelabs.com.br`)

Exemplo

Example

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

{
          "success": true,
          "data": {
            "dominio": "exemplo.com.br",
            "disponivel": false,
            "status": ["active"],
            "registrado_em": "2016-09-24T02:14:52Z",
            "expira_em": "2028-09-24T02:14:52Z",
            "nameservers": ["ns1.exemplo.com.br", "ns2.exemplo.com.br"]
          },
          "meta": { "elapsed_ms": 180, "request_id": "..." }
        }

Erros possíveis

Possible errors

Status	Motivo	Reason
400	domínio sem formato válido (sem ponto)	domain isn't in a valid format (no dot)
401	token ausente ou inválido	missing or invalid token
429	limite de taxa excedido	rate limit exceeded
503	dado indisponível no momento	data temporarily unavailable

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_...")
ctx := context.Background()

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

from alicercelabs import AlicerceLabs

client = AlicerceLabs(api_key="alk_...")

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

import { AlicerceLabs } from "alicercesdk-javascript";

const client = new AlicerceLabs("alk_...");

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

Limites

Limits

100/dia · 4/hora sem token, por IP chamador; com uma 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 an API key (generated in the panel), 1,000/day · 41/hour. Response cached for 1h.