Autenticação
Para aceder à API, um token de acesso deverá ser usado. Um Token está associado a um Utilizador autenticado numa Localização, num Terminal e numa Caixa, na sua empresa. Tudo o que for feito usando um Token, terá a autoria atribuída ao utilizador associado e reger-se-á pelas suas permissões na aplicação.
- BackOffice: Poderá criar Tokens acedendo ao BackOffice, em Empresa Tokens de Acesso à API, onde poderá atribuir o Token a um Utilizador, Localização e Terminal.
- Usando a própria API: Pode obter um Token fazendo um pedido ao end-point
/auth/login, incluindo as suas credenciais de autenticação, obtendo na resposta o Token que poderá utilizar nos pedidos posteriores.
post
https://api.cloudinvoice.net
/auth/login/
Gera um Token de Acesso para as credenciais fornecidas:
Exemplo de Pedido
Exemplo de Resposta
curl -X POST https://api.cloudinvoice.net/auth/login/
-d '{
"username": "[email protected]",
"password": "pFS2VwMk"
}'
{
"key": "329c2d5cadd96ccce7b0b0f2653e8d08f61ddd52"
}
Para além das credenciais username/password, pode também incluir a Empresa
company_code e a Caixa till_code a que pretende associar o token de acesso.Para efectuar pedidos com autenticação, deverá usar um dos seguintes métodos:
- Incluir o Header HTTP:
Authorization: Token <token>
curl https://api.cloudinvoice.net/customers/
-H "Content-Type: application/json"
-H "Authorization: Token 329c2d5cadd96ccce7b0b0f2653e8d08f61ddd52"
- Incluir o Query Param:
api_token=<token>
curl https://api.cloudinvoice.net/customers/?api_token=329c2d5cadd96ccce7b0b0f2653e8d08f61ddd52
-H "Content-Type: application/json"
Em pedidos
POST deve incluir sempre o Header:
Content-Type: application/json;Last modified 2mo ago