JoinVision offers a SOAP 1.1 interface for accessing the semantic extraction services. This page describes the different SOAP methods and explains their parameters and output in detail.
Address: https://cvlizer.joinvision.com/cvlizer/exservicesoap WSDL: https://cvlizer.joinvision.com/cvlizer/exservicesoap?wsdl |
Service Name: {http://servlets.iex.jv.com/}SemanticExtractionService Port Name: {http://servlets.iex.jv.com/}SemanticExtractionPort |
For each method you will need to provide your product token. How to find the product token is explained here.
Get the current contingent (e.g. number of conversions) left for a specific product.
Integer getContingent(String username, String password) |
Parameter | Type | Description |
---|---|---|
username | String | Your username |
password | String | Your product token |
If your request is successful, the API returns an Integer that describes the remaining contingent.
Returns a SOAPException in case of authentication issues.
Get the most recent domain value lists as XML.
String getXMLDomainsFor(String language) |
Parameter | Type | Description |
---|---|---|
language | String | The preferred Target Language in which the long-values of the domains should be returned. |
If your request is successful, the API returns a XML object with the most recent domain values:
<domains> <domain name="ISOCountry"> <pair code="PR" value="Puerto Rico"/> <pair code="PS" value="Palestina"/> ... </domain> ... </domains> |
Returns a SOAPException in case the provided language is invalid.
This method returns a structured XML containing all extracted information for a provided input file. Based on the selected Extraction Model, the returned XML validates against the respective XML Schema for the applied extraction mode.
The Target Language indicates in which language the long-values for the extracted abstraction codes (like skills, operation areas, education level, …) are returned. It does NOT define target or source language of the whole document. Text translation is not performed.
Extracting from an URL It is possible to pass an URL instead of a binary document. In this case, the parameter “filetype” is set to “url” and the parameter “document” has to contain the UTF-8 encoded URL itself |
String extractToXML(String username, String password, String language, String model, byte[] inputdata, String inputdatatype) |
Parameter | Type | Description |
---|---|---|
username | String | Your username |
Password | String | Your product token |
language | String | Preferred Target Language |
model | String | |
inputdata | byte[] | Document to be semantically extracted and transformed. Depending on the programming language in use (for instance Ruby and JavaScript) the byte array needs to be converted to a String and base64 encoded before submitting. |
inputdatatype | String | Filetype of the document (document postfix), e.g. 'docx' or the whole filename, e.g. 'document.pdf'. |
If the filename entered in parameter “inputdatatype” does not contain a postfix, the extraction will fail |
If your request is successful, the API returns a XML object as String, following the respective XML schema based on the chosen Extraction Model. More information on the returned XML can be found in the JoinVision XML 3.0 Schema Description.
Returns a SOAPException for any kind of extraction problems, containing a detailed error description.
JoinVision offers a document classification web service (called “Classifier”) which accepts a set of documents as input, converts each page of the document to PDF, determines the category of each page of the document, extracts the document's plain text and returns a set of categorized documents. The categorization service supports packaged files, like MIME-and MSG-Format (E-mails) and ZIP, also one enclosed in another (like an E-mail with ZIP-attachment). In case of mails the mail body is classified and returned as well.
OutputDoc[] categorize(InputDoc[] inputDocs, String domain, String username, String password) |
The required input consists of an array of InputDocs, whereas an inputDoc contains the name of the file (in order to determine the file type) and the file itself as byte array.
Parameter | Type | Description |
---|---|---|
inputDocs | inputDoc[] | An array of documents in the form of InputDocs |
domain | String | For classifications in the HR-domain, the domain value is always “hr” |
username | String | Your username |
password | String | Your product token |
If your request is successful, the API returns an array of OutputDocuments, which contains the binary document as byte array (always “pdf”), the amount of pages, whether or not the document has been OCR converted, the document's original filename, the document's plaintext, and the detected document's category.
Returns a SOAPException for any kinds of errors
This method returns a structured XML containing all extracted information for one or more provided input files of the simple type InputDoc (one of the files is required to be a CV). All provided files are classified, splitted if required, semantically extracted and merged into the CV-XML. Based on the selected extration mode, the returned XML validates against the respective XML Schema for the applied extraction mode. The target language String accords to ISO 639-1 (upper-case).
String mergeToXML(String username, String password, String language, String model, InputDoc[] inputDocs) |
The required input consists of an array of InputDocs, whereas an inputDoc contains the name of the file (in order to determine the file type) and the file itself as byte array.
Parameter | Type | Description | |
---|---|---|---|
username | String | Your username | |
password | String | Your product token | |
language | String | Preferred Target Language | |
model | String |
| |
inputDocs | inputDoc[] | An array of documents in the form of InputDocs
|
If your request is successful, the API returns a XML object as String, following the respective XML schema based on the chosen Extraction Model. More information on the returned XML can be found in the JoinVision XML 3.0 Schema Description.
Returns a SOAPException for any kind of extraction problems containing a detailed error description.