CA App Synthetic Monitor API 25.2.17/25.2.17 : cp_list

Retrieve checkpoint information

price: free!

parameter	type	default / required*	notes
nkey	token		Session key or token. Automatically assigned (only if optional) or obtained via acct_login/acct_token call.
type	enum (connect, ping, http, pop3, smtp, imap, gopher, ftp, telnet, script, scriptxl, scriptxxl, plugin, dnsa, dnsns, https, ftps, tftp, scp, sftp, sip, cscript, dns, domain, ldap, trace, browser, whois, browserscript, script_chrome, script_ie, script_firefox, tmpl_jmeter, tmpl_browser, se, webdriver, websocket, tls)		Filter on supported monitor type.
lang	string (2)	en	Language, two chararters, following ISO 639.
cap	set (ipv6)		Filter on list of capabilities. Comma separated list, no spaces.
info	boolean	n	Specify "y" to include checkpoint description.
deleted	boolean	n	Specify "y" to include deleted checkpoints.
cpns	string		Specify "*" to list OPMS checkpoints.
limit	unsigned int		Number of results to return.
format	enum (xml, csv, xls, tab)	xml	Output format for this call.
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>
  <checkpoints>
    <checkpoint>
      <id> unsigned int </id>
      <loc> string </loc>
      <locode> string </locode>
      <active> boolean </active>
      <host> string </host>
      <ip> string </ip>
      <country> string </country>
      <country_name> string </country_name>
      <city> string </city>
      <lat> real </lat>
      <lng> real </lng>
      <weight> unsigned int </weight>
      <descr> string </descr>
      <type> string </type>
      <tunnel_cid> unsigned int </tunnel_cid>
    </checkpoint>
    ...
  </checkpoints>
</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