Neste post será explicado como utilizar as rotas HTTP disponibilizadas para o consultar as UFs e Cidades utilizadas no cadastro de clientes na interface de Administração do Manager SaaS via API, nos anexos deste é possível realizar o download da aplicação em C#.
Atenção!
Para ser possível realizar a comunicação, primeiramente é necessário gerar o token que será necessário na autenticação da comunicação para o cadastro de grupos/empresas e na atualização de certificados, o mesmo é válido por 3 horas. Para isso, você pode acessar esse artigo e verificar como gera-lo.
Listar UF's
Para listar as UF's com o código da UF, sigla e descrição, basta enviar uma requisição GET na rota:
GET
https://managersaas.tecnospeed.com.br:1337/api/v1/uf?token=6edvc5y8n26opf1or158358984184&codigouf=41
Nome | Descrição | Exemplo |
token | Token da Software House | 6edvc5y8n26opf1or15835897444874 |
codigouf | Codigo da UF segundo o IBGE** | 41 |
** Tabela de Codigos das UFs IBGE
Exemplo de Retorno
{
"mensagem": "Registros retornados com sucesso",
"dados": [
{
"handle": 19,
"codigouf": 33,
"sigla": "RJ",
"descricao": "Rio de Janeiro"
}
],
"total": 1
}
Listar Cidades
Para listar cidades é possível informar o ID da UF que seria o Handle retornado na consulta demonstrada acima.
Utilizando a rota abaixo é possível obter apenas uma cidade ou todas as cidades disponíveis dentro da UF basta enviar uma requisição GET na rota:
GET
https://managersaas.tecnospeed.com.br:1337/api/v1/cidade?token=6edvc5y8n26opf1or158358984184&iduf=handle
Nome | Descrição | Exemplo |
token | Token da Software House | 6edvc5y8n26opf1or15835897444874 |
iduf | Handle retornado na consulta de UFs | 19 |
codigoibge | Código IBGE da Cidade a ser consultada | 3300225 |
{
"mensagem": "Registros retornados com sucesso",
"dados": [
{
"handle": 3178,
"iduf": 19,
"codigoibge": "3300225",
"descricao": "Areal",
"descricaopadrao": "AREALRJ",
"descricaopadraocomuf": "AREALRJ",
"nfsehomologada": true,
"nomepadrao": "BETHA"
}
],
"total": 1
}
Essa consulta por ser feita tanto com o iduf quanto com o codigoibge.
Comentários
0 comentário
Por favor, entre para comentar.