Manual - API Busca Agências

Manual de uso da API Busca Agências

1. Apresentação

1.1 Objetivo do Manual

Este material foi desenvolvido para contribuir no planejamento e integração com a API Busca Agências dos Correios do Brasil em qualquer plataforma desejada pelo cliente.

1.2 Escopo da API

A API Busca Agências tem o escopo exclusivo de consulta aos dados das unidades dos Correios pelos clientes detentores de contratos comerciais. Unidades podem ser: agências, postos de venda de produtos, lockers (armários inteligentes dos Correios), entre outros.

1.3 Público-Alvo

Esta API é indicada a todos os clientes que precisem de dados detalhados de unidades dos Correios, para serviços como:

  • Identificar as unidades pelo código da agência nas faturas;
  • Obter o endereço e o contato das unidades para facilitar a postagem ou retirada de objetos;
  • Verificar se a unidade presta o serviço Clique e Retire;
  • Listar unidades por tipo de unidade em um bairro, Cidade ou Estado, entre outros.

2. Visão Geral da API

2.1 Finalidade da API

A API Busca Agências permite retornar dados de endereço, nome, contato, dias e horários de funcionamento, entre outros, utilizando diversos parâmetros de pesquisa como nome, bairro, município, tipo de unidade, entre outros.

2.2 Funcionalidades Principais

  • Consultar unidades dos Correios;
  • Consultar parâmetros adicionais para filtrar a consulta de unidades, como tipos de unidade e status.

2.3 Arquitetura e Tecnologias Utilizadas

As APIs dos Correios foram desenvolvidas com a tecnologia REST. Este padrão de mercado permite a escolha de diversas linguagens de programação para integração, tais como: ASP, .Net, Java, PHP, Ruby, Python, entre outras.

Entre outras características, os atributos que mais se destacam na API são:

  • Ausência de aplicativos proprietários: Não há necessidade de instalação de um ambiente específico para utilizar a API.
  • Simplicidade: O protocolo utilizado é puramente o HTTPS.
  • Credenciais: O tratamento das credenciais do cliente trafega em ambiente seguro.

Tanto o corpo da requisição feita à API quanto a resposta recebida são em formato JSON, quando aplicável – visto que algumas requisições e respostas podem não possuir corpo.

2.4 Fluxo Geral de Integração
Sumário do Manual de uso da API Busca Agências-DIAGRAMA.png

3. Autenticação e Autorização

3.1 Métodos de Autenticação Suportados

Esta API utiliza exclusivamente o método de autenticação Bearer Token. O token deve ser obtido através da integração com a API Token. É fundamental observar a validade do token para que um novo seja gerado pelo mesmo processo quando o atual expirar.

Alternativamente, para facilitar o acesso de terceiros às APIs e sistemas dos Correios em nome de um cliente com contrato ativo, existe a opção de subdelegar acesso. A chave de acesso gerada será usada como token, conforme referência neste manual.

3.2 Obtenção de Credenciais

Para acessar a API Busca Agências com o nível adequado de credenciais, é necessário:

  • Possuir Conta de Pessoa Jurídica no Meu Correios;
  • Ter um Contrato comercial firmado junto aos Correios (exceto Clube Correios);
  • O contrato comercial deve conter o serviço API BUSCA AGÊNCIAS, código 86711. A confirmação pode ser feita na ficha técnica do contrato ou solicitando apoio comercial;
  • Deve ser criado código de acesso às APIs no CWS – Correios Web Services para geração do token;
  • O token utilizado deve ser gerado com o endpoint /v1/autentica/contrato, conforme documentação da API Token.

3.3 Escopos e Permissões

O escopo da API Busca Agências é apenas de consulta. Suas permissões refletem este escopo, sendo uma API simples, com poucos endpoints.

3.4 Exemplo de Requisição Autenticada

A requisição de exemplo para o endpoint /v1/status e sua respectiva resposta em JSON estão detalhadas abaixo:

Requisição

curl -X 'GET' \
'https://api.correios.com.br/agencia/v1/status' \
-H 'accept: application/json' \
-H 'Authorization: Bearer [TOKEN_DE_EXEMPLO]'

Resposta

[
{
"codigo": "1",
"descricao": "NÃO INSTALADO"
},
{
"codigo": "2",
"descricao": "INSTALADO"
},
{
"codigo": "3",
"descricao": "FECHADO PROVISORIAMENTE"
},
{
"codigo": "4",
"descricao": "EXTINTO"
},
{
"codigo": "5",
"descricao": "EM EXTINÇÃO"
},
{
"codigo": "6",
"descricao": "OUTROS"
}
]

4. Padrões Técnicos utilizados

4.1 Formato das Requisições e Respostas

Tanto o corpo da requisição feita à API quanto a resposta recebida são em formato JSON, quando aplicável – visto que algumas requisições e respostas podem não possuir corpo.

4.2 Endpoints (REST, etc.)

A API Busca Agências possui arquitetura REST e utiliza o protocolo HTTPS. É fornecida uma URL base e os verbos HTTP (como GET, POST, PUT, DELETE) indicam a ação requisitada pelo cliente.

4.3 Códigos de Status HTTP e Tratamento de Erros

Toda requisição enviada ao servidor retorna um código de status, dividido em cinco famílias:

  • 1xx – Informacionais
  • 2xx – Códigos de sucesso
  • 3xx – Códigos de redirecionamento
  • 4xx – Erros causados pelo cliente
  • 5xx – Erros originados no servidor

Alguns dos códigos mais importantes e utilizados são:

2xx (Sucesso)

200 – OK
Indica que a operação teve sucesso.
201 – Created
Indica que o recurso desejado foi criado com sucesso. Deve retornar um cabeçalho Location, contendo a URL do recurso recém-criado.
202 – Accepted
Indica que a solicitação foi recebida e será processada em outro momento (requisições assíncronas). Pode retornar um cabeçalho Location para consulta do status do recurso.
204 – No Content
Usualmente enviado em resposta a uma requisição PUT, POST ou DELETE, onde o servidor pode recusar-se a enviar conteúdo.

3xx (Redirecionamento)

301 – Moved Permanently
O recurso solicitado foi realocado permanentemente. A resposta deve conter um cabeçalho Location com a URL completa do novo local.
303 – See Other
Utilizado quando a requisição foi processada, mas o servidor não deseja enviar o resultado. O servidor envia a resposta com este código e o cabeçalho Location, informando onde a resposta do processamento está.
304 – Not Modified
Utilizado principalmente em requisições GET condicionais, quando o cliente deseja a resposta apenas se ela tiver sido alterada em relação a uma requisição anterior.
307 – Temporary Redirect
Similar ao 301, mas indica que o redirecionamento é temporário.

4xx (Erro do Cliente)

400 – Bad Request
Resposta genérica para qualquer tipo de erro de processamento cuja responsabilidade é do cliente do serviço.
401 – Unauthorized
Utilizado quando o cliente está tentando realizar uma operação sem ter fornecido dados de autenticação ou com autenticação inválida.
403 – Forbidden
Utilizado quando o cliente está tentando realizar uma operação sem ter a devida autorização.
404 – Not Found
Utilizado quando o recurso solicitado não existe.
405 – Method Not Allowed
Utilizado quando o método HTTP não é suportado pela URL. Deve incluir um cabeçalho Allow na resposta, listando os métodos suportados.
409 – Conflict
Utilizado quando há conflitos entre dois recursos (ex: criação de um usuário com login já existente). Se causado pela existência de outro recurso, a resposta deve conter um cabeçalho Location explicitando a localização do recurso que é a fonte do conflito.
410 – Gone
Semelhante ao 404, mas indica que um recurso já existiu neste local.
415 – Unsupported Media Type
Utilizado em resposta a clientes que solicitam um tipo de dados que não é suportado (ex: solicitar JSON quando o único formato suportado é XML).

5xx (Erro do Servidor)

500 – Internal Server Error
Resposta de erro genérica, utilizada quando nenhuma outra se aplica.
503 – Service Unavailable
Indica que o servidor está atendendo requisições, mas o serviço em questão não está funcionando corretamente. Pode incluir um cabeçalho Retry-After, dizendo ao cliente quando ele deveria tentar submeter a requisição novamente.

5. Documentação dos Endpoints

5.1 Estrutura de Documentação (método, URL, parâmetros, exemplo)

Para acesso à documentação completa da API, após todas as permissões devidamente recebidas, deve ser acessado o CWS - Correios Web Services. As instruções de acesso estão no Manual Correios Web Services.

Após preenchimento das credenciais e geração do token adequado, conforme item 7.2 do manual referenciado – lembrando que a API Busca Agências utiliza autorização por contrato, será possível encontrar no campo de pesquisa a API Agência V2 (76):

Sumário do Manual de uso da API Busca Agências-img1.png

A estrutura das requisições consiste na URL base e o endpoint, além do verbo (GET, POST, PUT, PATCH ou DELETE). Esses dados são conseguidos no próprio Swagger:

Sumário do Manual de uso da API Busca Agências-img2.png

Nesse exemplo, para invocar o endpoint, utilizamos o endereço https://api.correios.com.br/agencia/v1/unidades utilizando o verbo GET.

Recomendamos estudo intensivo dos dados disponibilizados nas páginas demonstradas acima, pois as atualizações são disponibilizadas primeiro no Swagger da API no CWS, que será sempre a documentação mais completa e atualizada.

Adicionalmente, o primeiro link, logo abaixo do nome da API, se trata da documentação em JSON, que pode ser baixada e importada em aplicativos de teste de APIs REST, como Postman, SoapUI, Katalon Studio, Swagger UI, Apidog, IntelliJ IDEA, P`yCharm, API Fortress, entre outros. Recomendamos se referir aos manuais desses aplicativos para aproveitar essa funcionalidade.

5.2 Endpoints por Domínio Funcional ou por categoria

Unidades

Finalidade: Identificar agências dos Correios por localidade, permitindo a verificação dos horários de funcionamento e as informações para contato.

Endpoints
GET /v1/unidades – Lista todas as unidades de forma paginada

Parâmetros obrigatórios: Nenhum. Cada parâmetro utilizado irá filtrar melhor os resultados.

Parâmetros opcionais:

  • id: refere-se a um identificador único nos Correios, conhecido como MCU, uma sequência numérica de 8 dígitos, exemplo: 00004178. Pode ser informada uma lista de ids;
  • status: código de status da unidade. Pode ser informada uma lista de status. Os status possíveis podem ser pesquisados no endpoint GET /v1/status;
  • cep: CEP da unidade. Aceita uma lista de CEPs. Pode ser obtido na consulta ao CEP, seja pela API Busca CEP, seja no site dos Correios;
  • codigoSro: código SRO da unidade. É similar ao CEP da unidade, mas identifica internamente o endereço nos Correios. Aceita uma lista de códigos;
  • codigoTipoUnidade: código de tipo de da unidade. Pode ser informada uma lista de códigos. Os tipos possíveis podem ser pesquisados no endpoint GET /v1/tipos;
  • nome: nome da unidade. Aceita parte do nome, ex: lista retorna a agência AC SAO JOAO EVANGELISTA, entre outras. Importante: não acentuar;
  • municipio: cidade onde se encontra a unidade, ex: Brasilia. Importante: não acentuar;
  • bairro: bairro onde se encontra a unidade, ex: Centro. Importante: não acentuar;
  • uf: sigla do Estado onde se encontra a unidade, ex: SP;
  • dhAlteracaoInicial e dhAlteracaoFinal: extensão de tempo (data inicial, data final) onde houve criação ou alteração em dados da unidade. O formato utilizado é AAAA-MM-DDThh:mm:ss, ex: 2025-09-30T12:30:59;
  • page, size e sort: parâmetros que definem a paginação de resultados, tornando a consulta mais rápida;
GET /v1/unidades/{id} – Consulta uma unidade

Parâmetros obrigatórios:

  • id: refere-se a um identificador único nos Correios, conhecido como MCU, uma sequência numérica de 8 dígitos, exemplo: 00004178.

Parâmetros opcionais: Nenhum.

Tipos de Unidades

Finalidade: Recupera os tipos de unidades.

Endpoints
GET /v1/tipos – Lista os tipos de unidades

Parâmetros obrigatórios: Nenhum.

Parâmetros opcionais: Nenhum.

Localidades

Finalidade: Recupera as localidades onde existem agências.

Endpoints
GET /v1/localidades – Lista as localidades das unidades

Parâmetros obrigatórios:

  • uf: sigla do Estado a ser pesquisado, ex: SP;

Parâmetros opcionais:

  • municipio: cidade onde se encontra a unidade, ex: Brasilia. Importante: não acentuar;
  • codigoTipoUnidade: código de tipo de da unidade. Pode ser informada uma lista de códigos. Os status possíveis podem ser pesquisados no endpoint GET /v1/tipos;
  • status: código de status da unidade. Os status possíveis podem ser pesquisados no endpoint GET /v1/status;

Status

Finalidade: Recupera os status existentes nas agências.

Endpoints
GET /v1/status – Lista os status das unidades

Parâmetros obrigatórios: Nenhum.

Parâmetros opcionais: Nenhum.

6. Exemplos de Integração

6.1 Exemplos requisições (ex: em Linguagens Populares)

  • Listar as unidades dos Correios no Centro de Plácido de Castro/AC:

Requisição

curl -X 'GET' \
  'https://api.correios.com.br/agencia/v1/unidades?municipio=placido%20de%20castro&bairro=centro&uf=ac&page=0&size=50' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer [TOKEN_DE_EXEMPLO]'

Resposta

{
  "itens": [
    {
      "id": "00056416",
      "codigoAntigo": "03300048",
      "codigoCadastroGeral": 1761789,
      "nome": "AC PLACIDO DE CASTRO",
      "ativa": true,
      "status": "2",
      "descStatus": "INSTALADO",
      "tipo": "A",
      "tipoUnidade": {
        "codigo": "09",
        "descricao": "AGENCIA CORREIO",
        "sigla": "AC -TCO"
      },
      "emails": [
        "acplacido@correios.com.br"
      ],
      "telefones": [
        "(68) 3237-1183"
      ],
      "endereco": {
        "cep": "69928970",
        "uf": "AC",
        "localidade": "PLACIDO DE CASTRO",
        "municipio": "PLACIDO DE CASTRO",
        "logradouro": "AV DIAMANTINO AUGUSTO DE MACEDO",
        "bairro": "CENTRO",
        "numero": "580",
        "codigoIbge": "1200385",
        "regiao": "NTE",
        "longitude": "-67.1865142",
        "latitude": "-10.3325157",
        "fuso": "UTC-05:00",
        "fusoVerao": "UTC-05:00"
      },
      "horarios": {
        "funcionamento": "SEGUNDA À SEXTA",
        "iniExpediente": "08:00",
        "fimExpediente": "16:00",
        "iniAlmoco": "12:00",
        "fimAlmoco": "14:00",
        "limitePostagemSemana": "11:00"
      },
      "codigoSro": [
        "69928970"
      ],
      "inCorreiosAtende": "S",
      "inCliqueRetire": "S",
      "dhAlteracao": "2025-09-17T14:06:33.717"
    }
  ],
  "links": [
    {
      "rel": "self",
      "href": "https://api.correios.com.br/agencia/v1/unidades?municipio=placido%20de%20castro&bairro=centro&uf=ac&page=0&size=50&sort=id,asc"
    }
  ],
  "page": {
    "size": 50,
    "totalElements": 1,
    "totalPages": 1,
    "number": 0
  }
}
  • Listar os tipos de unidades:

Requisição

curl -X 'GET' \
  'https://api.correios.com.br/agencia/v1/tipos' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer [TOKEN_DE_EXEMPLO]'

Resposta

[
  {
    "codigo": "09",
    "descricao": "AGENCIA CORREIO",
    "sigla": "AC -TCO"
  },
  {
    "codigo": "12",
    "descricao": "AG CORREIOS FRANQUEADA (AGF)",
    "sigla": "AGF-TCO"
  },
  {
    "codigo": "15",
    "descricao": "AGENCIA DE CORREIO SATELITE",
    "sigla": "ACS -TCO"
  },
  {
    "codigo": "16",
    "descricao": "AG CORREIOS FRANQUEADA (ACF)",
    "sigla": "ACF -TCO"
  },
  {
    "codigo": "18",
    "descricao": "POSTO DE CORREIO",
    "sigla": "PC -TCO"
  },
  {
    "codigo": "20",
    "descricao": "AGENCIA FILATELICA",
    "sigla": "AF -TCO"
  },
  {
    "codigo": "21",
    "descricao": "AG CORREIOS COMUNITARIA",
    "sigla": "AGC -TCO"
  },
  {
    "codigo": "24",
    "descricao": "POSTO DE VENDA DE PRODUTOS",
    "sigla": "PVP -TCO"
  },
  {
    "codigo": "25",
    "descricao": "AG CORREIOS COMER PROPRIA",
    "sigla": "ACCI -TCO"
  },
  {
    "codigo": "27",
    "descricao": "AG CORREIOS COMER TERCEIRIZ",
    "sigla": "ACCI -TCO"
  },
  {
    "codigo": "43",
    "descricao": "AG CORREIOS FRANQUEADA (AGF)",
    "sigla": "AGF-TCO (SEM LIMINAR)"
  },
  {
    "codigo": "46",
    "descricao": "LOCKER",
    "sigla": "LK-TCO"
  }
]
  • Listar os Lockers (armários inteligentes dos Correios – conforme exemplo anterior, o código do tipo é “46”) no Centro de São Paulo/SP:

Requisição

curl -X 'GET' \
  'https://api.correios.com.br/agencia/v1/unidades?codigoTipoUnidade=46&municipio=sao%20paulo&bairro=centro&page=0&size=50' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer [TOKEN_DE_EXEMPLO]'

Resposta

{
  "itens": [
    {
      "id": "00435133",
      "codigoAntigo": "00435133",
      "codigoCadastroGeral": 66959454,
      "nome": "LOCKER ESTACAO DA LUZ",
      "ativa": true,
      "status": "2",
      "descStatus": "INSTALADO",
      "tipo": "A",
      "tipoUnidade": {
        "codigo": "46",
        "descricao": "LOCKER",
        "sigla": "LK-TCO"
      },
      "endereco": {
        "cep": "01033989",
        "uf": "SP",
        "localidade": "SAO PAULO",
        "municipio": "SAO PAULO",
        "logradouro": "AVENIDA CASPER LIBERO",
        "bairro": "CENTRO",
        "complemento": "AREA PAGA",
        "numero": "598",
        "codigoIbge": "3550308",
        "regiao": "SDE",
        "longitude": "-46.63426560877594",
        "latitude": "-23.536277569985256",
        "fuso": "UTC-03:00",
        "fusoVerao": "UTC-03:00"
      },
      "horarios": {
        "funcionamento": "SEGUNDA À SEXTA,SÁBADO,DOMINGO",
        "iniExpediente": "04:40",
        "fimExpediente": "00:00",
        "iniSabado": "04:40",
        "fimSabado": "00:00",
        "iniDomingo": "04:40",
        "fimDomingo": "00:00"
      },
      "codigoSro": [
        "00435133"
      ],
      "dhAlteracao": "2025-04-23T12:06:37.476"
    }
  ],
  "links": [
    {
      "rel": "self",
      "href": "https://api.correios.com.br/agencia/v1/unidades?codigoTipoUnidade=46&municipio=sao%20paulo&bairro=centro&page=0&size=50&sort=id,asc"
    }
  ],
  "page": {
    "size": 50,
    "totalElements": 1,
    "totalPages": 1,
    "number": 0
  }
}

6.2 Casos de Uso Comuns

  • Pesquisar unidades próximas ao cliente, comprador ou vendedor.
  • Pesquisar dados das unidades de postagem listadas na fatura do cliente.
  • Listar lockers dos Correios por região.

7. Ambientes Disponíveis

7.1 Ambiente de Homologação

Para acesso ao ambiente de homologação do Correios Web Services (CWS), é necessário primeiro obter o acesso em produção, com o serviço devidamente habilitado no contrato, conforme item 3.2 deste manual.

Após o acesso ser completado em produção, o cliente deve entrar em contato com o representante comercial de seu contrato para pedir a replicação dos dados do contrato em homologação.

Por fim, o cliente deve criar uma conta no Meu Correios de homologação, vinculada aos mesmos dados do CNPJ já existente em produção. Isso é feito no endereço do Meu Correios de homologação, a saber: https://meucorreioshom.correios.com.br/

A documentação Swagger da API está disponível no endereço de homologação do CWS, ou seja: http://cwshom.correios.com.br/

7.2 Ambiente de Produção

Após os passos definidos neste manual, no item 3.2, o acesso do cliente em produção já está disponível.

A documentação Swagger da API está disponível no endereço de produção do CWS, ou seja: https://cws.correios.com.br/

8. Boas Práticas

8.1 Segurança na Integração

Os Correios recomendam os procedimentos de segurança padrão do mercado: não expor os códigos de acesso, mantê-los seguros em suas aplicações e não os repassar indiscriminadamente, utilizar sempre protocolo HTTPS e manter atualizada a aplicação.

Caso use uma empresa contratada para desenvolver sua aplicação, recomendamos fazer uso da subdelegação por chave de acesso, já citada neste manual. Tal chave precisa ser revogada ao término do desenvolvimento/contrato.

8.2 Validação de Dados

É importante validar todos os dados ao enviar à API. Os formatos de validação constam no CWS, conforme já citado neste manual.

9. Suporte e Contato

9.1 Canais de Suporte Técnico

9.2 Processo de Abertura de Chamados

O processo geral de abertura de chamados consiste em:

  1. Acessar a página dos Correios;
  2. Ir até o final da página e localizar Suporte ao cliente com contrato:

    Sumário do Manual de uso da API Busca Agências-img3.png

  3. Na tela seguinte, clicar em Sistemas Comerciais:

    Sumário do Manual de uso da API Busca Agências-img4.png

  4. Na próxima tela, selecionar Correios Web Services / APIs e depois Problemas com a integração:

    Sumário do Manual de uso da API Busca Agências-img5.png

  5. Preencher os dados do formulário e clicar em Enviar. É extremamente importante se valer do campo Arquivo até 10MB para anexar as evidências dos problemas encontrados, como imagens, arquivos JSON de requisição e resposta, entre outros. Se necessário, compacte os arquivos num único arquivo ZIP.

    Sumário do Manual de uso da API Busca Agências-img6.png

  6. O chamado foi aberto. Será recebido um e-mail de confirmação e a resposta será recebida também por e-mail.

Além da abertura de chamado, também é possível utilizar o contato telefônico com a Central de Atendimento dos Correios, informando o problema enfrentado.

Para os clientes com contato comercial junto aos Correios, não é necessário abertura de chamado. Basta contatar o gestor comercial do contrato e enviar as evidências dos problemas encontrados, nos mesmos moldes do processo de abertura de chamados.

Para clientes que contrataram outras empresas, como TMS, ERP, plataformas de e-commerce, entre outros, e são essas empresas que desenvolveram a integração, o chamado deve ser aberto na empresa contratada. Caso a empresa afirme que o problema é nos Correios, será necessário que a empresa forneça os dados necessários para abertura do chamado, conforme descrito no processo de abertura de chamados, ou essa empresa deve tratar diretamente com os Correios.

É fundamental que sempre sejam enviadas anexar as evidências dos problemas encontrados, como imagens, arquivos JSON de requisição e resposta, entre outros. Essa informação é essencial para a análise do problema por parte dos Correios.

10. Anexos

10.1 Glossário de Termos Técnicos

Termo Descrição
API Application Programming Interfaces (Interface de Programação de Aplicações): conjunto de regras e protocolos que permite a comunicação entre diferentes softwares, funcionando como uma ponte que facilita a troca de informações e funcionalidades entre eles.
API Manager Sistema gerador de tokens para acesso de APIs. Gera uma string codificada com a finalidade de garantir a segurança de quem está usando a API e evitar fraudes.
Autenticação Processo de verificação de uma identidade digital do usuário, ou seja, para assegurar que o usuário é realmente aquele quem diz ser.
Autorização Processo para verificar quais são os privilégios concedidos, para utilizar uma aplicação.
Cartão de postagem Cartão que identifica um usuário como cliente de contrato dos Correios.
CEP Código de Endereçamento Postal - código numérico de oito dígitos usado pelos Correios no Brasil para agilizar e organizar a entrega de correspondências e encomendas. Cada um dos oito dígitos do CEP tem um significado específico, começando pela divisão das regiões do país, que se subdividem até identificar um logradouro, um edifício, um grande usuário ou uma unidade dos Correios.
Código de acesso a APIs Código de acesso criado pelo usuário no site Correios Web Services que permite esse usuário utilizar os componentes disponibilizados pelos Correios.
Contrato comercial Instrumento que o cliente firma com os Correios para a prestação de serviços de encomendas, mensagens, marketing direto e outros.
CWS Correios Web Services – site principal para conhecimento e testes das integrações dos Correios: https://cws.correios.com.br
HTTPS Hypertext Transfer Protocol Secure: é a versão segura do protocolo HTTP, que utiliza a criptografia SSL/TLS para proteger os dados trocados entre o navegador de um usuário e um site. Ao contrário do HTTP, o HTTPS garante a confidencialidade, a integridade e a autenticidade da comunicação, impedindo que terceiros interceptem ou alterem informações sensíveis.
Locker Armário inteligente dos Correios. É um terminal de autoatendimento que oferece ao cliente dos Correios mais uma opção para devolver e retirar encomendas: https://www.correios.com.br/locker
Meu Correios Mecanismo de autenticação e autorização para acesso aos serviços que os Correios disponibilizam via internet.
REST Representational State Transfer - estilo de arquitetura de software que define princípios para a comunicação entre sistemas na web, tornando-os mais confiáveis, escaláveis e fáceis de modificar.
Token (ou bearer token) Credencial de segurança que concede acesso a recursos protegidos, funcionando com base na premissa "quem o possui, tem acesso", sem necessidade de identificação adicional. Ele é tipicamente usado na autenticação de APIs através do protocolo OAuth 2.0, onde é incluído no cabeçalho da requisição HTTP para verificar a identidade do cliente e autorizá-lo a acessar determinados recursos.
Unidade Denominação comum aos endereços dos Correios, se referindo tanto a agências de Correios (próprias ou franqueadas), pontos de coleta, centros de distribuição, postos de venda de produtos, entre outros.

10.2 Referências e links úteis

10.3 Histórico de Alterações da API e da respectiva documentação

Data Evento Versão Responsável Observações
30/09/2025 Criação 1.0 Correios -