User

Overview

Resources in user will return a <feed> containing one or more <entry> elements describing users, or an empty <feed> if no results matching your criteria can be found.

Resources

show

parameters

• id (required)

example

user/show?id=DST5G2X0BM26MRXY

Returns an entry describing the user specified by the id. The id parameter is a 16-digit alphanumeric string, as elsewhere. You can obtain the id from the find results below, any kind of entry referencing a user or the URI of the user's Magnify page.

find

parameters

• vq (required)

example

user/find?vq="John Smith"

Searches the channel's users in the same way as the normal channel search. Searches fields in the user profile as well as in the user's posted content.

Results

Feed Format

A standard feed with openseach metadata is produced, as described on the Feed page.

Entry Format

<entry>
  <link rel="self"
        href="http://dev7.qwerty.magnify.net/api/user/show?id=DST5G2X0BM26MRXY" />
  <link rel="alternate"
        href="http://dev7.qwerty.magnify.net/user/DST5G2X0BM26MRXY" />
  <link rel="content"
        href="http://dev7.qwerty.magnify.net/content/user?cid=DST5G2X0BM26MRXY" />
  <link rel="list"
        href="http://dev7.qwerty.magnify.net/list/user?cid=DST5G2X0BM26MRXY" />
  <magnify:id>DST5G2X0BM26MRXY</magnify:id>
  <id>http://example.magnify.net/api/user/show?id=DST5G2X0BM26MRXY</id>
  <name>J.R. Dobbs</name>

  <magnify:handle>Bob</magnify:handle>
  <magnify:photo>http://example.magnify.net/media/users/DST5G2X0BM26MRXY</magnify:photo>
</entry>

Important Elements

link: these elements are provided for convenience and offer links to useful related resources
• self: a feed containing only this entry (useful for getting individual entries from find results)
• alternate: the Magnify-hosted page for this user
• content: a feed containing videos belonging to this user
• list: a feed containing playlists belonging to this user
• magnify:name, magnify:handle, magnify:photo: user information
• magnify:id: the user's id number; valid for id=... parameters
• id: Atom-required entry id

Note

The elements in the magnify namespace are not recognized by most RSS readers and will not render when open in a browser. This does not interfere with use in your application.