NAV
bash javascript

Overview

Bem vindo a documentação da API Dev4Dev!!! Aqui você popde encontrar todas as informações a respeito dos serviços oferecidos, como devem ser realizadas as chamadas, incluindo até mesmo exemplos. Obter coleção Postman

CEP

Serviços relacionados ao CEP.

Busca CEP

O serviço de validação de CEP recebe como parâmetro o número do CEP e retorna se o mesmo é válido ou não.

Example request:

curl -X GET -G "https://dev4dev.com.br/api/cep/72405496" 
const url = new URL("https://dev4dev.com.br/api/cep/72405496");

let headers = {
    "Accept": "application/json",
    "Content-Type": "application/json",
}

fetch(url, {
    method: "GET",
    headers: headers,
})
    .then(response => response.json())
    .then(json => console.log(json));

Example response (200):

{
    "end": "Quadra EQ 47-49 Projeção 1",
    "bairro": "Setor Central (Gama)",
    "uf": "DF",
    "cidade": "Brasília",
    "cep": "72405496"
}

Example response (500):

{
    "message": "Server Error"
}

HTTP Request

GET api/cep/{cep}

Gerar CEP

O serviço de geração de CEP gera um número de CEP válido a cada chamada, observe que um CEP válido não é necessariamente um CEP real.

Example request:

curl -X GET -G "https://dev4dev.com.br/api/cep?format=true&city=1&state=1" 
const url = new URL("https://dev4dev.com.br/api/cep");

    let params = {
            "format": "true",
            "city": "1",
            "state": "1",
        };
    Object.keys(params).forEach(key => url.searchParams.append(key, params[key]));

let headers = {
    "Accept": "application/json",
    "Content-Type": "application/json",
}

fetch(url, {
    method: "GET",
    headers: headers,
})
    .then(response => response.json())
    .then(json => console.log(json));

Example response (200):

{
    "end": "Rua Projetada B",
    "bairro": "Edson Passos",
    "uf": "RJ",
    "cidade": "MESQUITA",
    "cep": "26584-037"
}

Example response (500):

{
    "message": "Server Error"
}

HTTP Request

GET api/cep

Query Parameters

Parameter Status Description
format optional bool Se o valor gerado deve ser formatado ou não. Valor padrão é 'false'.
city optional number Se o valor gerado deve ser formatado ou não.
state optional number Se o valor gerado deve ser formatado ou não.

Recurperar UFs

Recupera uma lista de UFs e seus ids para utilização na geração de CEPs.

Example request:

curl -X GET -G "https://dev4dev.com.br/api/uf" 
const url = new URL("https://dev4dev.com.br/api/uf");

let headers = {
    "Accept": "application/json",
    "Content-Type": "application/json",
}

fetch(url, {
    method: "GET",
    headers: headers,
})
    .then(response => response.json())
    .then(json => console.log(json));

Example response (500):

{
    "message": "Server Error"
}

HTTP Request

GET api/uf

Recupera Cidades

Recupera a lista de cidades para um determinada UF para utilização na funcionalidade de geração de CEPs.

Example request:

curl -X GET -G "https://dev4dev.com.br/api/cidade/1" 
const url = new URL("https://dev4dev.com.br/api/cidade/1");

let headers = {
    "Accept": "application/json",
    "Content-Type": "application/json",
}

fetch(url, {
    method: "GET",
    headers: headers,
})
    .then(response => response.json())
    .then(json => console.log(json));

Example response (500):

{
    "message": "Server Error"
}

HTTP Request

GET api/cidade/{uf}

CNPJ

Serviços relacionados a CNPJ.

Validador de CNPJ

O serviço de validação de CNPJ recebe como parâmetro o número do CNPJ e retorna se o mesmo é válido ou não. O algoritmo de validação aplicado é descrito aqui.

Example request:

curl -X GET -G "https://dev4dev.com.br/api/cnpj/80125936101960" 
const url = new URL("https://dev4dev.com.br/api/cnpj/80125936101960");

let headers = {
    "Accept": "application/json",
    "Content-Type": "application/json",
}

fetch(url, {
    method: "GET",
    headers: headers,
})
    .then(response => response.json())
    .then(json => console.log(json));

Example response (200):

{
    "cnpj": "80.125.936\/1019-60",
    "valid": true
}

HTTP Request

GET api/cnpj/{cnpj}

Gerador de CNPJ

O serviço de geração de CNPJ gera um número de CNPJ válido a cada chamada, observe que um CNPJ válido não é necessariamente um CNPJ real. O algoritmo de geração aplicado é descrito aqui.

Example request:

curl -X GET -G "https://dev4dev.com.br/api/cnpj?format=distinctio" 
const url = new URL("https://dev4dev.com.br/api/cnpj");

    let params = {
            "format": "distinctio",
        };
    Object.keys(params).forEach(key => url.searchParams.append(key, params[key]));

let headers = {
    "Accept": "application/json",
    "Content-Type": "application/json",
}

fetch(url, {
    method: "GET",
    headers: headers,
})
    .then(response => response.json())
    .then(json => console.log(json));

Example response (200):

{
    "cnpj": "38181666353085"
}

HTTP Request

GET api/cnpj

Query Parameters

Parameter Status Description
format optional bool Se o valor gerado deve ser formatado ou não. Valor padrão é 'false'

CPF

Serviços relacionados a CPF.

Validador de CPF

O serviço de validação de CPF recebe como parâmetro o número do CPF e retorna se o mesmo é válido ou não. O algoritmo de validação aplicado é descrito aqui.

Example request:

curl -X GET -G "https://dev4dev.com.br/api/cpf/84318398218" 
const url = new URL("https://dev4dev.com.br/api/cpf/84318398218");

let headers = {
    "Accept": "application/json",
    "Content-Type": "application/json",
}

fetch(url, {
    method: "GET",
    headers: headers,
})
    .then(response => response.json())
    .then(json => console.log(json));

Example response (200):

{
    "cpf": "843.183.982-18",
    "valid": true
}

HTTP Request

GET api/cpf/{cpf}

Gerador de CPF

O serviço de geração de CPF gera um número de CPF válido a cada chamada, observe que um CPF válido não é necessariamente um CPF real. O algoritmo de geração aplicado é descrito aqui.

Example request:

curl -X GET -G "https://dev4dev.com.br/api/cpf?format=deserunt" 
const url = new URL("https://dev4dev.com.br/api/cpf");

    let params = {
            "format": "deserunt",
        };
    Object.keys(params).forEach(key => url.searchParams.append(key, params[key]));

let headers = {
    "Accept": "application/json",
    "Content-Type": "application/json",
}

fetch(url, {
    method: "GET",
    headers: headers,
})
    .then(response => response.json())
    .then(json => console.log(json));

Example response (200):

{
    "cpf": "38502663038"
}

HTTP Request

GET api/cpf

Query Parameters

Parameter Status Description
format optional bool Se o valor gerado deve ser formatado ou não. Valor padrão é 'false'

Rede

Serviços relacionados a rede.

Consulta DNS

O serviço de busca de registros DNS tem como entrada o tipo de registro e domínio e retornam o valor do registro DNS.

Example request:

curl -X GET -G "https://dev4dev.com.br/api/rede/dns/A/dev4dev.com.br" 
const url = new URL("https://dev4dev.com.br/api/rede/dns/A/dev4dev.com.br");

let headers = {
    "Accept": "application/json",
    "Content-Type": "application/json",
}

fetch(url, {
    method: "GET",
    headers: headers,
})
    .then(response => response.json())
    .then(json => console.log(json));

Example response (200):

[
    "104.27.130.123",
    "104.27.131.123"
]

HTTP Request

GET api/rede/dns/{registro}/{dominio}

WHOIS

O serviço de recuperação das informações de um domínio (WHOIS) recebe um domínio e retorna o resultado da chamada a ferramenta WHOIS.

Example request:

curl -X GET -G "https://dev4dev.com.br/api/rede/whois/dev4dev.com.br" 
const url = new URL("https://dev4dev.com.br/api/rede/whois/dev4dev.com.br");

let headers = {
    "Accept": "application/json",
    "Content-Type": "application/json",
}

fetch(url, {
    method: "GET",
    headers: headers,
})
    .then(response => response.json())
    .then(json => console.log(json));

Example response (200):

{
    "whois": "\n% Copyright (c) Nic.br\n%  The use of the data below is only permitted as described in\n%  full by the terms of use at https:\/\/registro.br\/termo\/en.html ,\n%  being prohibited its distribution, commercialization or\n%  reproduction, in particular, to use it for advertising or\n%  any similar purpose.\n%  2019-11-10T20:39:55-03:00\n\ndomain:      dev4dev.com.br\nowner:       Guilherme Cruz\nownerid:     069.347.219-77\ncountry:     BR\nowner-c:     GUCRU47\nadmin-c:     GUCRU48\ntech-c:      GUCRU48\nbilling-c:   GUCRU48\nnserver:     cash.ns.cloudflare.com\nnsstat:      20191110 AA\nnslastaa:    20191110\nnserver:     lana.ns.cloudflare.com\nnsstat:      20191110 AA\nnslastaa:    20191110\nsaci:        yes\ncreated:     20190608 #19754073\nchanged:     20190618\nexpires:     20200608\nstatus:      published\nprovider:    GODADDY (86)\n\nnic-hdl-br:  GUCRU47\nperson:      Guilherme Cruz\ne-mail:      [email protected]\ncountry:     BR\ncreated:     20190608\nchanged:     20190608\nprovider:    GODADDY (86)\n\nnic-hdl-br:  GUCRU48\nperson:      Guilherme Cruz\ne-mail:      [email protected]\ncountry:     BR\ncreated:     20190608\nchanged:     20190608\nprovider:    GODADDY (86)\n\n% Security and mail abuse issues should also be addressed to\n% cert.br, http:\/\/www.cert.br\/ , respectivelly to [email protected]\n% and [email protected]\n%\n% whois.registro.br accepts only direct match queries. Types\n% of queries are: domain (.br), registrant (tax ID), ticket,\n% provider, contact handle (ID), CIDR block, IP and ASN.\r\n"
}

HTTP Request

GET api/rede/whois/{dominio}