SkyBoT

The method status is intended to people who need to know the status of the SkyBoT database.

If you are a software/solutions developer, you might want to include the SkyBoT skybotstatus service into your application. This can be done by using the web service method or by using the following HTTP request:

https://ssp.imcce.fr/webservices/skybot/api/status.php?[parameters]

where [parameters] is a list of parameters separated by the character &. The allowed parameters are:

Parameter	Definition	Limits
`-mime=<string>`	Mime type of the results	votable \| html \| text \| json
`-ep=<dateTime>`	Epoch covered by the database for which the status is requested	all (default) \| now \| Y-m-d [h:m:s]
`-project=<string>`	Name of one of the SkyBoT databases	sbot2 (default) \| sbotRosetta \| sbotKepler \| sbotEarthL2 \| sbotTESS
`-from=<string>`	Word which define the name of the caller application, or which describes the request	any short string (no space character)

The output results are described in the following section, and are available in VOTable (default), HTML, plain text format, and JSON object (cf. examples). The -mime argument is optionnal and its value can be omitted (just write nothing or ...&-mime= without value). In this case, the output is displayed as VOTable. The argument -ep is also optionnal (just write nothing or ...&-ep= without value). If omitted, the status of the SkyBoT database is given for all periods of time.

The SkyBoT Web service provides methods based on SOAP and HTTP POST verb which allow one to interact between its own application and the SkyBoT service. Here is the useful information to invoke the SkyBoT skybotstatus method:

Web Service URI:: https://ssp.imcce.fr/webservices/skybot/skybot.php
Namespace:: https://ssp.imcce.fr/webservices/skybot
WSDL:: https://ssp.imcce.fr/webservices/skybot/skybot.php?wsdl
SOAP header:: name of the SOAP header element: clientID; SOAP header's content: array('from' => 'YourName', 'hostip'=>'')
Method:: skybotstatus (inputArray)

The input parameter of the method is an array which must contained the following parameter:

Variable	Type	Units	Limits or values	Default	Comment
`mime`	string	-	votable \| html \| text \| json	votable	Mime type of the results
`epoch`	dateTime	-	empty \| Y-m-d [h:m:s]	empty	Epoch covered by the database for which the status is requested
`project`	string	-	sbot2 \| sbotRosetta \| sbotKepler \| sbotEarthL2 \| sbotTESS	sbot2	Name of one of the SkyBoT databases

The output of the skybotstatus method is an object containing the following attributes:

'flag': the status of the response: flag=1 means ok; flag=0 or flag=-1 mean that an error occured
'status': the HTTP status-code of the response (e.g. 400: bad request, 422: Unprocessable Entity, 500: internal error)
'ticket': the Unix timestamp of the response which can be useful to stamp the request
'result': a string containing the status of SkyBoT database, described in the output results section

Depending on the selected mime type, the output is formatted as:

votable: the data are written in the IVOA standard VOTable format
html: the data are transformed from VOTable to HTML by XSLT processing (SkyBoT XSL style sheet)
text: the data are returned in plain text where each value is separated by the pipe '|' character
json: the data are written in a JSON object.

Click on the following links to get the status of SkyBoT with:

The output parameters of the method is a string which contains information which contains the following information:

Field	Definition	Value
1	Status of the database	'ok', 'update in progress', 'check in progress', 'unavailable'
2	Starting date of the time span covered by the database	julian day
3	Ending date of the time span covered by the database	julian day
4	Number of asteroids in the database	-
5	Number of planets in the database	-
6	Number of natural satellites in the database	-
7	Number of comets in the database	-
8	Date of the last update	dateTime (ISO format)

When the output mime type is the JSON data-interchange format, the status of SkyBoT service is encapsulated into a structure defined as follows:

[ 
  {
    "Status": {string}, 
    "Date_start": {dateTime}, 
    "Date_end": {dateTime}, 
    "obj_aster": {int}, 
    "obj_planet": {int}, 
    "obj_satel": {int}, 
    "obj_comet": {int}, 
    "Last_update": {dateTime} 
  }
]

You have two ways to use the SkyBoT web service: by writting a client to send requests to the SkyBoT server and to receive and analyze the response, or by using a command line interface and a data transfert program such as curl or wget. For example, you can execute the following command in a console:

$> wget "<URL>"

where <URL> is described in section HTTP request.

In order to help you to invoke the SkyBoT web service, we provide some clients written in differents languages. Here are some detailed explanations to write a client with PHP and SOAP which invokes the skybotstatus method:

1/ Provide the input parameters which are mandatory for the service:

// Client's ID: provide the name of your project or organisation or yourself
$from = 'MyName';
// Input parameters
$param = array('mime' => "text", 'project' => "sbot2");

2/ Define the SOAP options, the namespace and the WSDL URI of SkyBoT web service:

// Enables or disables the WSDL caching feature
ini_set('soap.wsdl_cache_enabled', 1);
// SkyBoT namespace
$namespace = 'https://ssp.imcce.fr/webservices/skybot';
// SkyBoT WSDL
$uriwsdl = $namespace.'/skybot.wsdl';

3/ Create a SoapClient object in WSDL mode, set the SOAP header, then call the method and catch exceptions:

try {
   // Constructs the client
   $client = new SoapClient($uriwsdl, array('exceptions'=>1));
   // SOAP header
   $header = array('from'=>$from, 'hostip'=>'', 'lang'=>'en');
   $client->__setSoapHeaders(array(new SOAPHeader($namespace, 'clientID', $header)));  
   // Call the resolver method
   $response = $client->__soapCall('skybotstatus',$param);
   // Display the results
   if ($param['mime'] == 'text') {
      header("HTTP/1.0 200");
      header("Content-Type: text/plain");
      $res = explode(';', $response->result);
      $nbr = count($res);
      $newkey = array_keys($res);
      for ($i=0; $i<$nbr; $i++) { echo $res[$newkey[$i]].PHP_EOL; }
    } else if ($param['mime'] == 'json') {
      header("HTTP/1.0 200");
      header("Content-Type: application/json");
      echo $response->result;
   } else {
      header("HTTP/1.0 200");
      header("Content-Type: text/xml;content=x-votable");
      echo $response->result;
   }
} 
catch (SoapFault $fault) 
{
   trigger_error("SOAP Fault: {$fault->getTraceAsString()} (faultcode: {$fault->faultcode},
                               faultstring: {$fault->faultstring})", E_USER_ERROR);
}

status

Availability of SkyBoT service

HTTP Request

Web service

Query examples

Output results

Structure of the output JSON object

How to consume