חומר עזר · חשבון

המשתמש שלך

GET /v1/me

מחזיר את המשתמש שהמפתח שייך לו ואת פרטי המפתח ששימש בבקשה. אפשר להשתמש בו כדי לבדוק שהמפתח עובד.

פרמטרים

נקודת הקצה הזו לא מקבלת פרמטרים.

שדות התגובה

uid string: מזהה המשתמש.
name string: שם המשתמש.
email string: כתובת האימייל של המשתמש.
language string: שפת המשתמש בלוח הבקרה, בפורמט pt_BR.
api_key object: המפתח ששימש בבקשה זו.
api_key.name string: השם שניתן למפתח כשנוצר.
api_key.prefix string: תחילת המפתח, כפי שהיא מוצגת בלוח הבקרה. המפתח המלא לא מוצג שוב לעולם.
api_key.created_at string: מתי המפתח נוצר.
api_key.last_used_at string | null: השימוש האחרון שנרשם במפתח, מתעדכן לכל היותר פעם ב-5 דקות, או null.

שגיאות אפשריות

שגיאות המפתח ומגבלת הבקשות חלות על כל נקודות הקצה. כל השגיאות

בקשהcURLPHPJavaScript

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();

תגובה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"
    }
  }
}