Referência · Conta

O seu utilizador

GET /v1/me

Mostra o utilizador a quem pertence a chave e os dados da chave utilizada no pedido. Utilize-o para testar se a chave funciona.

Parâmetros

Este endpoint não recebe parâmetros.

Campos da resposta

uid string
Identificador do utilizador.
name string
Nome do utilizador.
email string
E-mail do utilizador.
language string
Idioma do utilizador no painel, no formato pt_BR.
api_key object
Chave utilizada neste pedido.
api_key.name string
Nome dado à chave quando foi gerada.
api_key.prefix string
Início da chave, o mesmo que aparece no painel. A chave completa nunca volta a ser apresentada.
api_key.created_at string
Quando a chave foi gerada.
api_key.last_used_at string | null
Última utilização registada da chave, atualizada no máximo a cada 5 minutos, ou null.

Erros possíveis

Pedido
curl "https://api.on-cloud.live/v1/me" \
  -H "X-API-Key: $API_KEY"
<?php
$ch = curl_init('https://api.on-cloud.live/v1/me');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['X-API-Key: ' . getenv('API_KEY')],
]);
$response = json_decode(curl_exec($ch), true);
const res = await fetch('https://api.on-cloud.live/v1/me', {
  headers: { 'X-API-Key': process.env.API_KEY }
});
const { data } = await res.json();
Resposta200
{
  "data": {
    "uid": "3c59dc048e8850243be8079a5c74d079",
    "name": "Mariana Souza",
    "email": "mariana@exemplo.com.br",
    "language": "pt_BR",
    "api_key": {
      "name": "Monitoramento",
      "prefix": "apk_527d541b",
      "created_at": "2026-11-01T09:15:42-03:00",
      "last_used_at": "2026-11-03T14:31:58-03:00"
    }
  }
}