Tokens de API
Criar token
Cria token de API para um usuário.
Somente o usuário principal da conta pode executar essa chamada.
POST /v1/token
$ curl -i https://api.gocache.com.br/v1/token \
-X POST \
-H 'GoCache-Token:seu_token' \
-d 'email=usuario@dominio.com.br'
<?php
$ch = curl_init("https://api.gocache.com.br/v1/token");
curl_setopt($ch, CURLOPT_POST, TRUE);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
curl_setopt($ch, CURLOPT_HTTPHEADER, array("GoCache-Token: seu_token"));
$urls = array(
"email=usuario@dominio.com.br"
);
curl_setopt($ch, CURLOPT_POSTFIELDS, implode("&", $urls));
$response = curl_exec($ch);
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
?>
Parâmetro
Campo | Opcional | Tipo | Descrição |
---|---|---|---|
Opcional | String | E-mail do usuário. |
HTTP/1.1 200 OK
{
"token":"aabbccddeeff00112233445566",
"success":true,
"status":200
}
<?php
if( $statusCode == 200 ) {
echo("Sucesso!\n");
$obj = json_decode($response);
echo("Resultado: " . $obj->success . "\n");
}
?>
Listar Tokens
Lista todos os tokens de API da conta.
Somente o usuário principal da conta pode executar essa chamada.
GET /v1/token
$ curl -i https://api.gocache.com.br/v1/token \
-X GET \
-H 'GoCache-Token:seu_token'
<?php
$ch = curl_init("https://api.gocache.com.br/v1/token");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
curl_setopt($ch, CURLOPT_HTTPHEADER, array("GoCache-Token: seu_token"));
$response = curl_exec($ch);
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
?>
HTTP/1.1 200 OK
{
"response":[
{"token":"aabbccddeeff00112233445566","email":"joao@dominio.com.br"},
{"token":"00112233445566778899aabbcc","email":"maria@dominio.com.br"}
],
"status":200,
"count":2
}
<?php
if( $statusCode == 200 ) {
echo("Sucesso!\n");
$obj = json_decode($response);
echo("Tokens encontradas:\n");
foreach($obj->response as $token) {
echo($token->token . " from user: ".$token->email."\n");
}
}
?>
Remover token
Remove uma token de API.
Somente o usuário principal da conta pode executar essa chamada.
DELETE /v1/token
$ curl -i https://api.gocache.com.br/v1/token \
-X DELETE \
-H 'GoCache-Token:seu_token'
-d 'token=aabbccddeeff00112233445566'
<?php
$ch = curl_init("https://api.gocache.com.br/v1/token");
curl_setopt($ch, CURLOPT_DELETE, TRUE);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
curl_setopt($ch, CURLOPT_HTTPHEADER, array("GoCache-Token: seu_token"));
$urls = array(
"token=bababababababababbabababa"
);
curl_setopt($ch, CURLOPT_POSTFIELDS, implode("&", $urls));
$response = curl_exec($ch);
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
?>
Parâmetros
Campo | Opcional | Tipo | Descrição |
---|---|---|---|
token | String | Token do usuário |
HTTP/1.1 200 OK
{
"success": true
}
<?php
if( $statusCode == 200 ) {
echo("Sucesso!\n");
}
?>
Renovar token
Renovar token de API para um usuário.
Somente o usuário principal da conta pode executar essa chamada.
Expira a token antiga e gera uma nova.
POST /v1/token
$ curl -i https://api.gocache.com.br/v1/token \
-X POST \
-H 'GoCache-Token:seu_token' \
-d 'email=usuario@dominio.com.br'
-d 'token=aabbccddeeff00112233445566'
<?php
$ch = curl_init("https://api.gocache.com.br/v1/token");
curl_setopt($ch, CURLOPT_PUT, TRUE);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
curl_setopt($ch, CURLOPT_HTTPHEADER, array("GoCache-Token: seu_token"));
$urls = array(
"email=usuario@dominio.com.br"
"token=babababababababbabababa"
);
curl_setopt($ch, CURLOPT_POSTFIELDS, implode("&", $urls));
$response = curl_exec($ch);
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
?>
Parâmetros
Campo | Opcional | Tipo | Descrição |
---|---|---|---|
String | Email do usuário | ||
token | String | Token de API do usuário |
HTTP/1.1 200 OK
{
"token":"aabbccddeeff00112233445566",
"success":true,
"status":200
}
<?php
if( $statusCode == 200 ) {
echo("Sucesso!\n");
$obj = json_decode($response);
echo("Resultado: " . $obj->success . "\n");
}
?>