API de Registro
O que é uma API?
A interface de programação de aplicativos (API, por sua sigla em inglês) é um conjunto de comandos, funções e protocolos informáticos usados para integrar sistemas sem necessidade de saber como estão implementados.
As API fornecem flexibilidade, simplificam o desenho, o gerenciamento e uso dos aplicativos e oferecem oportunidades para novos produtos e inovação.
À medida que as API se tornaram mais conhecidas, foram desenvolvidas especificações para permitir a padronização da troca de informações. Uma dessas especificações é a transferência de estado representacional (REST, por suas siglas em inglês).
As API web que funcionam com as limitações da arquitetura REST são chamadas de API RESTful. São, em termos simples, as API que usam métodos HTTP para obter dados ou realizar operações nesses dados em vários formatos (como XML e JSON).
Perguntas frequentes
É uma API baseada em REST, com autenticação por meio de Oauth. Seu principal objetivo é o gerenciamento em massa dos recursos disponíveis através da plataforma MiLACNIC.
Hoje tem duas versões. A versão 2.0 usa a especificação OpenAPI, cuja interface de usuário (Swagger-ui) mostra a documentação da API de forma interativa, permitindo que desenvolvedores e usuários testem seus serviços.
A versão mais atualizada (versão 3) tem sua documentação no Postman, um aplicativo que nos permite testar APIs e nos ajuda a otimizar o tempo de execução dos testes.
A API de Registro do LACNIC está disponível para todos os associados do LACNIC que solicitarem credenciais de acesso.
Que serviços inclui a API de Registro do LACNIC?
|
Recursos |
Serviços |
Endpoints |
Versão API |
|
Organizações |
Alta |
/entity/organizations |
v2, v3 |
|
Modificação, obter informações |
/entity/organizations/{orgid} |
||
|
Obter recursos organização |
/entity/resources/{orgid} |
v3 |
|
|
Contatos |
Obter informações |
/entity/users/{id} |
v2, v3 |
|
Blocos IP |
Alta (subdesignação) |
/ips |
v2, v3 |
|
Baixa, modificação (contatos e outros), obter informações |
/ips/{prefix}/{prefixLength} |
||
|
Inversos DNS |
Alta |
/domains |
v2, v3 |
|
Baixa, modificação |
/domains/{prefix}/{prefixLength} |
||
|
ASN |
Obter informações, modificação (contatos) |
/asns/{id} |
v2, v3 |
|
Certificates |
Obter informações, Alta, modificação, Baixa |
rpki/certs |
v2, v3 |
|
ROAs |
Obter informações, Alta |
/rpki/roas |
v2, v3 |
|
Modificação, Baixa |
/rpki/roas/{serialNumber} |
||
|
IRR |
Alta, Baixa |
/irr |
v2, v3 |
|
AS-SETs |
Obter informações, Alta |
/irr/assets |
v2, v3 |
|
Baixa |
/irr/assets/{nameAsSet} |
||
|
RateLimit |
Obter informações |
/ratelimits |
v2, v3 |
|
Geofeeds |
Alta |
/geofeeds |
v3 |
|
Obter informações |
/geofeeds/{orgid} |
||
|
Modificação, Baixa |
/geofeeds/{prefix}/{prefixLength} |
Como solicitar acesso?
Para solicitar acesso à API de Registro do LACNIC, envie um e-mail para hostmaster [at] lacnic [.] net com os seguintes dados:
- OrgId
Poderá acessar as credenciais através da plataforma MiLACNIC, na seção Ferramentas/Beta do menu.
Como acessar à API de Registro do LACNIC?
Plataforma de testes
Assim que o pedido de acesso for aprovado, você poderá acessar nossa plataforma de testes clicando no link abaixo:
Versão 2.0:
https://registro-demo.api.lacnic.net/lacnic/2.0/swagger-ui/index.html
Versão 3:
https://registro-demo.api.lacnic.net/lacnic/v3/info
Plataforma de produção
Versão 2.0:
https://registro.api.lacnic.net/lacnic/2.0/swagger-ui/index.html
Versão 3:
https://registro.api.lacnic.net/lacnic/v3/info
Se você precisar acessar à API de Registro e não é associado do LACNIC, pode usar nossa plataforma de testes. Para pedir acesso, envie um e-mail para hostmaster [at] lacnic [.] net