Labels V2


API Versions

This documentation relates to an old version of the greenID API. Version 2 was deprecated in October 2017. See greenID API for the current version.

The sourceField and rawData elements of the responses contain labels and tooltips for the various data fields. There are two forms these labels/tooltips can take: 

  1. Handlebars templates of the form {{{label_name}}}. For an example, see the rawData example in the Interpreting Results section. Handlebars templates allows a customer to customise the content of the label by using the Handlebars Javascript templating engine. For more information on Handlebars, the reader is referred to the Handlebars website: http://www.handlebarsjs.com/ 
  2. A translated label using greenID defaults. For an example, see the sourceFields example in the Interpreting Results section above.

An account configuration option is set to determine which of these will be returned. The default setting is to translate labels to the greenID defaults. Please contact VIX Verify to change which option is used.

Alternatively, label translation can be disabled on a per-request basis by passing an extraData parameter to the getFields web method. If the optionalDatacontains a name-value pair with the name "disable.label.translation" and the value "true", then label translation will be skipped for that request. The request below shows an example of a getFields call with label translation disabled:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:dyn="http://dynamicform.services.registrations.edentiti.com/">
   <soapenv:Header/>
   <soapenv:Body>
      <dyn:getFields>
         <accountId>YOUR_ACCOUNT_ID</accountId>
         <password>YOUR_WEB_SERVICE_PASSWORD</password>
         <verificationId>A_VERIFICATION_ID</verificationId>
         <sourceId>nswregodvs</sourceId>
         <extraData>
            <name>disable.label.translation</name>
            <value>true</value>
         </extraData>         
      </dyn:getFields>
   </soapenv:Body>
</soapenv:Envelope>