# Primeiros passos na API 2.0
Está com pressa? Resumo da história...
- Disponibilizamos uma API REST, totalmente HTTPS.
- O formato de dados que trafegamos na API é JSON (
Content-Type: application/json). - Trabalhamos com pares de chaves para autenticação AppId e AppKey. Você deve enviar essas chaves por meio de HTTP Headers.
- A URL base da nossa API 2.0 é:
https://api.umov.me/v2
# Conceitos iniciais
A API 2.0 é uma nova forma de integração com o uMov.me, através de protocolos e padrões mais modernos!
A implementação do serviço segue conceitos de REST (opens new window) para organização de recursos em diferentes endpoints.
Estabelecendo a comunicação no formato JSON (opens new window), a API 2.0 utiliza dos padrões de mercado amplamente difundidos e aceitos no contexto de comunicação entre serviços.
Seguindo os padrões de segurança necessários para a garantia de confidencialidade dos dados, o protocolo de comunicação com os endpoints da API 2.0 utilizado o HTTPS (opens new window).
# Autenticação
A nível de autenticação, utilizamos o padrão de par de chaves AppId e AppKey.
Esse conjunto de chaves deve ser sempre informado nos headers (opens new window) das requisições HTTP realizadas na API 2.0.
O AppId será sempre único por ambiente uMov.me, já o AppKey é um token expirável que deve ser gerenciado pelo administrador do ambiente uMov.me.
# Gerenciamento de tokens da API 2.0
No momento, para a criação/expiração de AppKey (tokens da API 2.0), é necessário entrar em contato com o suporte da uMov.me e solicitar a criação/expiração de um token para a API 2.0.
Em breve, disponibilizaremos a gerência de tokens da API 2.0 dentro da interface da plataforma uMov.me!