Knowledge Base: users.view

users.view

Method Type: GET
Required Parameters: username
Optional Parameters: api_key, user_token

Displays the information for one user as well as an array of avatar images.

If an api_key and owners user_token are present the users email address will be returned also.

Usage

https://api.emberapp.com/users/view/{username}.xml

// OR

https://api.emberapp.com/users/view/{username}?api_key={api_key}&user_token={user_token}

Response

Each image is returned in an images array with the following parameters.

user:

username:       Users username and unique identifier. [string]
fullname:       Users fullname. [string]
bio:            Users bio. [string]
url:            Users homepage. [string]
created:        Unix timestamp user joined Ember. [int]
subscriber:     True if the user currently has a subscription. [bool]
total_images:   Total images the user has uploaded to Ember. [int]
total_followers:Total followers the user has.
total_following:Total users the current user is following.
avatar:         Array containing the medium avatar information. [array]

avatar:

size:           Size flag of the image (s, m, l). [string]
width:          Width in px of the avatar image. [int]
height:         Height in px of the avatar image. [int]
filesize:       Size in bytes of the avatar file. [int]
src:            Url to the image file for the avatar. [string]

Example XML Response

<?xml version="1.0"?>
<response>
    <status code="0">OK</status>
    <api>api.users.view</api>
    <user>
        <username>ac94</username>
        <fullname>Aron</fullname>
        <bio>I'm a web developer at Realmac Software</bio>
        <url>http://www.emberapp.com</url>
        <created>1224762809</created>
        <avatars>
            <avatar>
                <size>s</size>
                <width>60</width>
                <height>60</height>
                <filesize>152078</filesize>
                <src>http://emberapp.com/ac94/avatars/s.png</src>
            </avatar>
            <avatar>
                <size>m</size>
                <width>128</width>
                <height>128</height>
                <filesize>152078</filesize>
                <src>http://emberapp.com/ac94/avatars/m.png</src>
            </avatar>
            <avatar>
                <size>l</size>
                <width>256</width>
                <height>256</height>
                <filesize>152078</filesize>
                <src>http://emberapp.com/ac94/avatars/l.png</src>
            </avatar>
        </avatars>
        <subscriber>1</subscriber>
        <total_images>76</total_images>
        <total_followers>0</total_followers>
        <total_following>0</total_following>
    </user>
</response>