Autenticação da API¶
A autenticação da API do Emites é feita via HTTP Basic (RFC2617). As credenciais de acesso, no caso seu token, devem ser criadas na página de gerênciamento da API.
O contexto padrão da API Emites é a conta. Cada conta tem seu token de acesso, ficando disponível para qualquer usuário que tenha acesso a conta.
Exemplo de autenticação:
curl --basic -u "[token]:x" -X GET -H "Accept: application/json" -H "Content-type: application/json" https://sandbox.emites.com.br/api/v1
Atenção: É recomendado passar algum valor como senha. Por exemplo o cURL obriga o uso da senha.
Cabeçalho:
Status Code: 200
Date: Wed, 20 Nov 2013 19:53:28 GMT
Vary: Accept
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Corpo de exemplo da resposta:
{
"id": 1,
"uuid": "9f6d1e5c-yygg-aaaa-cfrd-1bd1f40f7745",
"name": "Pull4up",
"expiration_date": "2014-12-06"
"emission_count": 99
"max_emissions": "Ilimitado"
"plan": {
"name": "Emites Ilimitado"
"slug": "emites-unlimited"
},
"emitters": [{
"_links": [{
"href": "https://app.emites.com.br/api/v1/emitters/1",
"method": "GET",
"rel": "self"
}, {
"href": "https://app.emites.com.br/api/v1/emitters/1",
"method": "PUT",
"rel": "update"
}, {
"href": "https://app.emites.com.br/api/v1/emitters/1",
"method": "PATCH",
"rel": "partial_update"
}, {
"href": "https://app.emites.com.br/api/v1/emitters/1",
"mehod": "DELETE",
"rel": "destroy"
}],
"certificate_filename": "certificate.pfx"
"id": 3
"account_id": 1
"email": "example@example.com.br"
"cnpj": "53836095000144"
"social_reason": "Foo Bar",
"fancy_name": "Foo",
"state_inscription": "ISENTO"
"city_inscription": "05725984"
"state": "RJ"
"city": "Rio de Janeiro"
"city_code": 3304557
"neighborhood": "Centro"
"street": "Rua do Carmo"
"number": "77"
"complement": ""
"zip_code": "20011020"
"phone": "12313213212"
"code_tax_regime": null
"is_active": true
"environment": "sandbox"
"country_code": "01058"
"street_type": "RUA"
}]
}