リファレンス · アカウント

現在のユーザー

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。

発生しうるエラー

リクエスト
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"
    }
  }
}