DOTS Name Validation 2

• Introduction
• Developer Guide Map
• Integration Basics

Introduction

DOTS Name Validation 2 is an XML and JSON RESTful web service that provides information about a person’s name. With DOTS Name Validation 2, users can validate names, verify name accuracy, fix unordered names and return gender information.

Developer Guide Map

• Operations
  • This section lists the DOTS Name Validation 2 operations and goes into the details behind the inputs and outputs. 
    • Operations:
      • NameInfoV2(Recommended Operation)
      • NameInfo
• Options and Codes
  • This section shows additional supporting data tables returned by DOTS Name Validation 2 operations.

• Errors
  • This section reflects details on the error outputs that can happen with the service.

• Code Snippets and Sample Code
  • Here you’ll find code snippets for various programming languages and frameworks along with links to our sample code page on the web site.

• Try The API
  • This is where you’ll go to take the API for a spin.  There you can test our recommended operation NameInfoV2.

• Service Reference
  • In this section you’ll find all the different endpoints supported by this service, input and output schema information as well as an opportunity to try the other endpoints as well.

• Frequently Asked Questions
  • This is a list of some of the questions we hear more often that you can reference and get answers on right away.

Integration Basics

• Integrating NV2 into your application should be easy and straightforward.  If you are using a common platform, Service Objects may already have sample code built that you can use:

• https://www.serviceobjects.com/developers/sample-code/
• However, if you are using a common platform that does not already have sample code, you can ask Service Objects to build you an example.  Email support@serviceobjects.com for more details.

• Web Service Structure

• Web services are methods that integrate with other applications via the web and encapsulate tricky business logic.  Web services are too large of a topic to cover in this document, but Service Objects has developed its web services to be as easy to integrate and as accessible as possible.
• NV2 is a public XML and JSON web service that supports SOAP, POST and GET operations, using RESTful paradigms or simple HTTP transport calls.

• The host path, or physical location of the web service is here:
  https://trial.serviceobjects.com/NV2/api.svc

• A test page for the web service can be found here:
  https://trial.serviceobjects.com/nv2/

• The location of the WSDL, or Web Service Definition Language document, is here (This is also accessible via the “Service Definition” link.):
  https://trial.serviceobjects.com/NV2/api.svc?wsdl

• Every web service has operations that it offers to subscribers – methods that do different work and return different output.  Examining the link above, you will notice several of these operations available, which are described in detail later on.