Litmus:Web Services: Difference between revisions

From MozillaWiki
Jump to navigation Jump to search
Line 5: Line 5:


== Sending results to the server ==
== Sending results to the server ==
=== Submission ===
Testing clients will open an http connection to 'http://litmus.mozilla.org/process_test.cgi'. Clients must send via HTTP POST an XML document containing test results and metadata for submission. Results are formatted as described in the [[Litmus:Test_Result_Format_DTD | Test Result Format DTD]].
Testing clients will open an http connection to 'http://litmus.mozilla.org/process_test.cgi'. Clients must send via HTTP POST an XML document containing test results and metadata for submission. Results are formatted as described in the [[Litmus:Test_Result_Format_DTD | Test Result Format DTD]].
Upon receipt, the server will process the test results. If a fatal error occurs, then no results will be added to the database. If some results are formatted properly, those results will be added even though other results may have errors.
=== Response ===
In the interest of simplicity, full XML responses will not be sent. After processing the results, the server will return:
* The string 'ok' if all results were added to the database successfully.
* An error string beginning with the words 'Fatal error' if the result data cannot not be parsed or lacks required information.
* An error string beginning with the words 'Error processing result for test n' where n is the id of the test that resulted in the error.

Revision as of 19:56, 13 June 2006

Litmus Web Services Specification

Sending testcases to the client

TBA

Sending results to the server

Submission

Testing clients will open an http connection to 'http://litmus.mozilla.org/process_test.cgi'. Clients must send via HTTP POST an XML document containing test results and metadata for submission. Results are formatted as described in the Test Result Format DTD.

Upon receipt, the server will process the test results. If a fatal error occurs, then no results will be added to the database. If some results are formatted properly, those results will be added even though other results may have errors.

Response

In the interest of simplicity, full XML responses will not be sent. After processing the results, the server will return:

  • The string 'ok' if all results were added to the database successfully.
  • An error string beginning with the words 'Fatal error' if the result data cannot not be parsed or lacks required information.
  • An error string beginning with the words 'Error processing result for test n' where n is the id of the test that resulted in the error.