Referencia · Účet

Váš používateľ

GET /v1/me

Vráti používateľa, ktorému kľúč patrí, a údaje o kľúči použitom v požiadavke. Hodí sa na otestovanie, či kľúč funguje.

Parametre

Tento endpoint nemá žiadne parametre.

Polia odpovede

uid string
Identifikátor používateľa.
name string
Meno používateľa.
email string
E-mail používateľa.
language string
Jazyk používateľa v ovládacom paneli vo formáte pt_BR.
api_key object
Kľúč použitý v tejto požiadavke.
api_key.name string
Názov, ktorý kľúč dostal pri vygenerovaní.
api_key.prefix string
Začiatok kľúča, rovnaký ako v ovládacom paneli. Celý kľúč sa už nikdy znova nezobrazí.
api_key.created_at string
Kedy bol kľúč vygenerovaný.
api_key.last_used_at string | null
Posledné zaznamenané použitie kľúča (aktualizuje sa najviac raz za 5 minút), alebo null.

Možné chyby

Požiadavka
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();
Odpoveď200
{
  "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"
    }
  }
}