API para DDDs do Brasil

API

A API é definida na mesma estrutura do site, no domínio http://ddd.pricez.com.br.

Para receber os dados como JSON, é necessário usar a extensão .json no final da URL ou definir o cabeçalho HTTP Accept='application/json'.

Rota: /ddds

Lista de todos os DDDs do Brasil. No Brasil, são 67 DDDs.

http://ddd.pricez.com.br/ddds
{
    "count": 67,
    "payload": [
        11,
        12,
        13,
        ...
    ]
}

Rota: /ddds/<ddd>

Lista das cidades no <ddd>.

http://ddd.pricez.com.br/ddds/92
{
    "count": 24,
    "payload": [
        {
            "cidade": "Autazes",
            "ddd": 92,
            "estado": "AM"
        },
        {
            "cidade": "Barreirinha",
            "ddd": 92,
            "estado": "AM"
        },
        ...
    ]
}

Rota: /estados

Lista dos estados brasileiros.

http://ddd.pricez.com.br/estados
{
    "count": 27,
    "payload": [
        "AC",
        "AL",
        "AM",
        ...
    ]
}

Rota: /estados/<estado>

Lista das cidades no <estado>.

http://ddd.pricez.com.br/estados/am
{
    "count": 62,
    "payload": [
        {
          "cidade": "Alvar\u00e3es",
          "ddd": 97,
          "estado": "AM"
        },
        {
          "cidade": "Amatur\u00e1",
          "ddd": 97,
          "estado": "AM"
        },
        ...
    ]
}

Rota: /cep/<cep>

Busca o CEP no Postmon e adiciona um campo para o DDD. Todos os dados definidos pelo Postmon são retornados.

http://ddd.pricez.com.br/cep/01001000
{
    "payload": {
        "bairro": "S\u00e9",
        "cep": "01001000",
        "cidade": "S\u00e3o Paulo",
        "complemento": "lado \u00edmpar",
        "estado": "SP",
        "logradouro": "Pra\u00e7a da S\u00e9",
        "ddd": 11
    }
}