現在のユーザーを取得
現在認証されているユーザーに関する情報を取得します。
クライアント側で認証されるOAuth 2.0アプリケーションの場合、これはアプリケーションを承認したユーザーになります。
サーバー側でアプリケーションが認証されるJWTの場合、これはデフォルトでアプリケーションに属するサービスアカウントになります。
このAPIコールに使用するユーザーを変更するには、As-Userヘッダーを使用します。
リクエスト
bearer [ACCESS_TOKEN]
application/json
クエリパラメータ
string arrayクエリ内省略可能
id,type,nameレスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。
こ のパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。
レスポンス
application/jsonユーザー (Full)
1つのユーザーオブジェクトを返します。
application/jsonクライアントエラー
予期しないクライアントエラー。
リクエストの例
cURL
curl -i -X GET "https://api.box.com/2.0/users/me" \
-H "authorization: Bearer <ACCESS_TOKEN>"TypeScript Gen
await client.users.getUserMe();Python Gen
client.users.get_user_me().NET Gen
await client.Users.GetUserMeAsync();Java
BoxUser user = BoxUser.getCurrentUser(api);
BoxUser.Info info = user.getInfo();Python
current_user = client.user().get().NET
BoxUser currentUser = await client.UsersManager.GetCurrentUserInformationAsync();Node
client.users.get(client.CURRENT_USER_ID)
.then(currentUser => {
/* currentUser -> {
type: 'user',
id: '33333',
name: 'Example User',
login: 'user@example.com',
created_at: '2012-03-26T15:43:07-07:00',
modified_at: '2012-12-12T11:34:29-08:00',
language: 'en',
space_amount: 5368709120,
space_used: 2377016,
max_upload_size: 262144000,
status: 'active',
job_title: 'Employee',
phone: '5555555555',
address: '555 Office Drive',
avatar_url: 'https://app.box.com/api/avatar/deprecated' }
*/
});iOS
client.users.getCurrent(fields: ["name", "login"]) { (result: Result<User, BoxSDKError>) in
guard case let .success(user) = result else {
print("Error getting user information")
return
}
print("Authenticated as \(user.name), with login \(user.login)")
}レスポンスの例
{
"id": "11446498",
"type": "user",
"address": "900 Jefferson Ave, Redwood City, CA 94063",
"avatar_url": "https://www.box.com/api/avatar/large/181216415",
"can_see_managed_users": true,
"created_at": "2012-12-12T10:53:43-08:00",
"enterprise": {
"id": "11446498",
"type": "enterprise",
"name": "Acme Inc."
},
"external_app_user_id": "my-user-1234",
"hostname": "https://example.app.box.com/",
"is_exempt_from_device_limits": true,
"is_exempt_from_login_verification": true,
"is_external_collab_restricted": true,
"is_platform_access_only": true,
"is_sync_enabled": true,
"job_title": "CEO",
"language": "en",
"login": "ceo@example.com",
"max_upload_size": 2147483648,
"modified_at": "2012-12-12T10:53:43-08:00",
"my_tags": [
"important"
],
"name": "Aaron Levie",
"notification_email": {
"email": "notifications@example.com",
"is_confirmed": true
},
"phone": "6509241374",
"role": "admin",
"space_amount": 11345156112,
"space_used": 1237009912,
"status": "active",
"timezone": "Africa/Bujumbura",
"tracking_codes": [
{
"type": "tracking_code",
"name": "department",
"value": "Sales"
}
]
}