CA App Synthetic Monitor API 24.7.7/24.7.7 : ch_log

Retrieve message(s) from one account. Filter by specifying type or date range.

price: 1 api credit

parameter	type	default / required*	notes
nkey	token	*	Session key or token. Automatically assigned (only if optional) or obtained via acct_login/acct_token call.
acct	string		Account e-mail. If left empty, then the request is on behalf of the account that is logged in (nkey).
type	enum (email, sms, icq, fax, phone, group, script, page, msn, jabber, nabaztag, action, twitter, rss, push)		Type of contact.
address	string (255)		Address of the contact.
format	enum (xml, csv, xls, tab)	xml	Output format for this call.
reverse	boolean	n	Reverse order in output of this call.
start_date	date		Starting date, format YYYY-MM-DD.
end_date	date		End date, format YYYY-MM-DD.
cursor	unsigned int		Return results relative to last cursor returned.
start	unsigned int	0	Paginate: start with result with this offset - DEPRECATED.
num	unsigned int	50	Number of results to return.
callback	string		Callback function for JSONP style calls. When this parameter is given, the result will be JSON instead of XML.
view	enum (xml, json)	xml	Specifies the desirable representation of the output (XML or JSON). HTTP Accept header can be used and has precedence.

Result:

<result>
  <messages>
    <message>
      <id> int </id>
      <type> enum (email, sms, icq, fax, phone, group, script, page, msn, jabber, nabaztag, action, twitter, rss, push) </type>
      <alerttype> string </alerttype>
      <address> string (255) </address>
      <detail> string </detail>
      <gw> string </gw>
      <status> int </status>
      <rid> unsigned int </rid>
      <severity> unsigned int </severity>
      <rootcause> string </rootcause>
      <sent> datetime </sent>
    </message>
    ...
  </messages>
  <cursor> unsigned int </cursor>
</result>

(presence of output fields depends on input parameters)

Error codes:

code	description
0	okay
1000	authentication error
1001	call syntax error
1002	undefined name or id
1003	account limit exceeded
1004	database error
1005	duplicate entry
1006	upgrade account
1007	not yours (anymore)
1008	session expired
1009	insufficient credits
1010	messaging error
1011	undefined result
1012	cannot perform that operation
1013	illegal parameter value
1014	TOS restriction
1015	unconfirmed address
1016	contact helpdesk first
9999	unsupported feature
1017	value not allowed

<<back to index