Web Services

Most Mutalyzer functionality is programmatically available through two interfaces: a SOAP web service and a HTTP/RPC+JSON web service.

Consider subscribing to our low-traffic mutalyzer-announce mailing list if you're using our webservices. Whenever there are important changes to the webservices upcoming, we will announce them there.

SOAP web service

A WSDL description is available for easy generation of client programs in many languages. See the annotated API for detailed documentation.

The following are some example client programs for SOAP web service. They use the checkSyntax method to determine if a variant description adheres to the HGVS format.

• Python client using the suds library: client-suds.py
• Python client using the soappy library: client-soappy.py
• Ruby client using the Savon library: client-savon.rb
• Mono client in C#: client-mono.cs
• PHP client using the PHP5 SOAP extension: client-php.php

Here is an example that could be used for text mining on a sample input file.

HTTP/RPC+JSON web service

The HTTP/RPC+JSON web service is experimental and currently undocumented. It can be called using HTTP GET requests on https://v2.mutalyzer.nl/json/method?param=value where method is the name of the method to be called and method parameters are expected as param=value query string parameters. Responses are JSON-encoded.

Example:

checkSyntax?variant=AB026906.1:c.274del

For now, you can work from this example using the above mentioned annotated SOAP API, since the HTTP/RPC+JSON web service mirrors the functionality of the SOAP web service.

Note: Since method parameters are passed as HTTP query string parameters, they need to be properly encoded as such. Depending on the programming language used, there most likely is a library available to do this. Here's an interface to do it directly from the browser for testing purposes.