Referència · Compte

El vostre usuari

GET /v1/me

Retorna l'usuari propietari de la clau i les dades de la clau utilitzada a la sol·licitud. Feu-lo servir per comprovar si la clau funciona.

Paràmetres

Aquest endpoint no admet paràmetres.

Camps de la resposta

uid string
Identificador de l'usuari.
name string
Nom de l'usuari.
email string
Correu electrònic de l'usuari.
language string
Idioma de l'usuari al tauler, en el format pt_BR.
api_key object
Clau utilitzada en aquesta sol·licitud.
api_key.name string
Nom que es va donar a la clau quan es va generar.
api_key.prefix string
Començament de la clau, el mateix que es mostra al tauler. La clau completa no es torna a mostrar mai.
api_key.created_at string
Quan es va generar la clau.
api_key.last_used_at string | null
Darrer ús registrat de la clau, que s'actualitza com a màxim cada 5 minuts, o null.

Errors possibles

Sol·licitud
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"
    }
  }
}