Venue ID API: Admin Methods: activity

Purpose

This method allows any authenticated admin user to query the Activity Log. It is necessary to specify a search_type, and depending on the search_type given, it may also be necessary to provide data for the search (all search types currently available require data to be provided).

URLs

Live: http://api.ives.info/rest/admin/activity

Input

Required Arguments
user_email For authentication
user_password For authentication
search_type Specify type of search (see below)
data Required for certain search types (see below)

Search Type Details Data
1 Returns all log entries from last 7 days in which the given venue_id was affected venue_id
2 Returns all log entries from last 7 days in which the given user_email was affected user_email
3 Returns all log entries from last 7 days in which the given user_email initiated an action user_email
4 Returns all log entries from last 7 days in which the given ip_address was the client's IP ip_address
5 Returns email addresses of all users who have performed activity in the last 7 days n/a

Sample Request
http://api.ives.info/rest/admin/activity?user_email=user@domain.com&user_password=fak3passw0rd&search_type=2&data=dave@yahoo.com

Output

See information about the Activity Log for help with interpreting the output.

Errors will be returned in the form of an error document.

Sample XML Output
<?xml version="1.0" encoding="UTF-8"?>
<search>
  <total_items>3</total_items>
  <entries>
    <entry>
      <timestamp>2008-11-11 12:37:57</timestamp>
      <ip_address>81.136.134.125</ip_address>
      <user>user@domain.com</user>
      <action>12</action>
      <status>1</status>
      <error_code>0</error_code>
    </entry>
    <entry>
      <timestamp>2008-11-11 12:43:35</timestamp>
      <ip_address>81.136.134.125</ip_address>
      <user>user@domain.com</user>
      <action>16</action>
      <status>1</status>
      <error_code>0</error_code>
    </entry>
    <entry>
      <timestamp>2008-11-11 12:48:28</timestamp>
      <ip_address>81.136.134.125</ip_address>
      <user>user@domain.com</user>
      <action>16</action>
      <status>0</status>
      <error_code>99</error_code>
    </entry>
  </entries>
</search>