Validator.nu Web Service Interface: Difference between revisions
(→Compression: Document it)
|Line 38:||Line 38:|
Revision as of 17:48, 27 November 2007
Validator.nu can be called as a Web service. Input and output modes can be chosen completely orthogonally. Responses can be optionally compressed.
For most Web service use cases, you should probably POST the document as the HTTP entity body.
- Document URL as a GET parameter; the service retrieves the document by URL over HTTP or HTTPS.
- Document POSTed as the HTTP entity body; parameters in query string as with GET.
- Document POSTed as a
- Document POSTed as a form-based file upload.
- Document in a
data:URI as a GET parameter.
When using Validator.nu as a Web service back end, the XML and JSON output formats are recommended for forward compatibility. The available JSON tooling probably makes consuming JSON easier. The XML format contains XHTML elaborations that are not available in JSON. Both formats are streaming, but streaming XML parsers are more readily available. XML cannot represent some input strings faithfully.
- HTML with microformat-style
classannotations (default output; should not be assumed to be forward-compatibly stable).
- XHTML with microformat-style
&out=xhtmlto URL; should not be assumed to be forward-compatibly stable).
- XML (append
- JSON (append
- Human-readably plain text (append
&out=textto URL; should not be assumed to be forward-compatibly stable for machine parsing).
- GNU error format (needs a better spec)
- Relaxed-compatible (lacks a spec)
- Unicorn-compatible (hoping that Unicorn changes instead)
- W3C Validator-compatible SOAP (legacy)
- EARL (not implemented; domain modeling mismatch)
Validator.nu supports HTTP response compression. Please use it. Response compression is orthogonal to the input methods and output formats.
The standard HTTP gzip mechanism is used. To indicated that you prepared to handle gzipped responses, include the
Accept-Encoding: gzip request header. When the header is present, Validator.nu will compress the response. You should also be prepared to receive an uncompressed, though, since in the future it may make sense to turn off compression under heavy CPU load.
HTTP request compression is not supported yet.