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"
    }]
}