Para realizar requisição na API usando a sua própria conta, basta usar o Token de Acesso disponível na interface do sistema no menu Integrações > API > Token de API.
Confira o ambiente
O Token é diferente entre o ambiente de sandbox e o ambiente de produção.
Requisição Válida
Segue um exemplo de requisição para testar se o token está funcionando.
Considerando que o seu Token de Acesso é zjuio96wkixkzy6z98sy
curl -i \
-H "Authorization: Bearer zjuio96wkixkzy6z98sy" \
-H 'Content-Type: application/json' \
-H 'User-Agent: MyApp ([email protected])' \
-X GET 'https://api-sandbox.kobana.com.br/v1/userinfo'
BoletoSimples.configure do |c|
c.access_token = 'zjuio96wkixkzy6z98sy'
end
BoletoSimples::Extra.userinfo
BoletoSimples::configure(array(
"access_token" => 'zjuio96wkixkzy6z98sy'
));
BoletoSimples\\Extra::userinfo();
Retorno:
HTTP/1.1 200 OK
Date: Fri, 17 Oct 2014 18:14:56 GMT
Status: 200 OK
...
{"id":1,"login_url":"https://api-sandbox.kobana.com.br/welcome?email=user%40example.com\\u0026token=xxx","email":"[email protected]","account_type":null,"first_name":null,"middle_name":null,"last_name":null,"full_name":null,"cpf":null,"date_of_birth":null,"mother_name":null,"father_name":null,"account_level":0,"phone_number":null,"address_street_name":null,"address_number":null,"address_complement":null,"address_neighborhood":null,"address_postal_code":null,"address_city_name":null,"address_state":null,"business_name":null,"business_cnpj":null,"business_legal_name":null}
{
"id": 1,
"login_url": "https://api-sandbox.kobana.com.br/welcome?email=user%40example.com&token=xxx",
"email": "[email protected]",
"account_type": null,
"first_name": null,
"middle_name": null,
"last_name": null,
"full_name": null,
"cpf": null,
"date_of_birth": null,
"mother_name": null,
"father_name": null,
"account_level": 0,
"phone_number": null,
"address_street_name": null,
"address_number": null,
"address_complement": null,
"address_neighborhood": null,
"address_postal_code": null,
"address_city_name": null,
"address_state": null,
"business_name": null,
"business_cnpj": null,
"business_legal_name": null
}
Array
(
[id] => 1
[login_url] => https://api-sandbox.kobana.com.br/welcome?email=user%40example.com&token=xxx
[email] => [email protected]
[account_type] =>
[first_name] =>
[middle_name] =>
[last_name] =>
[full_name] =>
[cpf] =>
[date_of_birth] =>
[mother_name] =>
[father_name] =>
[account_level] => 0
[phone_number] =>
[address_street_name] =>
[address_number] =>
[address_complement] =>
[address_neighborhood] =>
[address_postal_code] =>
[address_city_name] =>
[address_state] =>
[business_name] =>
[business_cnpj] =>
[business_legal_name] =>
)
Requisição Inválida
Segue um exemplo de requisição quando o token é inválido.
curl -i \
-H "Authorization: Bearer tokeninvalido" \
-H 'Content-Type: application/json' \
-H 'User-Agent: MyApp ([email protected])' \
-X GET 'https://api-sandbox.kobana.com.br/v1/userinfo'
BoletoSimples.configure do |c|
c.access_token = 'tokeninvalido'
end
BoletoSimples::Extra.userinfo
BoletoSimples::configure(array(
"access_token" => 'tokeninvalido'
));
BoletoSimples\\Extra::userinfo();
Retorno:
HTTP/1.1 401 Unauthorized
Date: Fri, 17 Oct 2014 18:20:18 GMT
Status: 401 Unauthorized
...
{"error":"Você precisa se logar ou registrar antes de prosseguir."}
BoletoSimples::ResponseError: 401 GET https://sandbox.boletosimples.com.br/api/v1/userinfo.json (Você precisa se logar ou registrar antes de prosseguir.)
\(See full trace by running task with --trace)
Fatal error: Uncaught exception 'BoletoSimples\\ResponseError' with message 'Você precisa se logar ou registrar antes de prosseguir.'