Pular para conteúdo

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
email 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
email 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");
}
?>