A autenticação na API é realizada através do método HTTP Basic
Utilizando a chave da API no campo destinado ao usuário, sem a necessidade de informar uma senha.
Vale lembrar que a API Vindi só pode ser utilizada através do protocolo HTTPS. Por motivos de segurança, requisições HTTP não serão redirecionadas automaticamente para o protocolo HTTPS.
Para obter sua chave da API, acesse:
-
Clique em "Configurações" e depois selecione "Chaves de acesso"
Segue abaixo um exemplo de requisição utilizando o comando curl:
curl <https://app.vindi.com.br/api/v1/payment_methods>
-H Content-Type:application/json
-u API_KEY:
No exemplo acima, a autenticação é informada com o atributo -u no formato username:password.
Conforme foi mencionado, não é necessário informar a senha, porém o separador ":" continua obrigatório.
Recomendamos a definição explícita do protocolo TLS v1.2 nos parâmetros da sua integração.
A API da plataforma Vindi suporta conexões HTTPS exclusivamente através do protocolo TLS v1.2.
O suporte às versões 1.0 e 1.1 do TLS foi descontinuado em 20/04/2018. Após esta data, integrações que usam estas versões deixarão de funcionar.