DOTS IP Address Validation

• Introduction
• Developer Guide
• Integration Basics

Introduction

DOTS IP Address Validation (referred to as “IP Address Validation”) is a publicly available XML web service that provides lookup information about an IP address. The service provides city, state, country, latitude and longitude coordinates, and proxy, ISP, and network information.

IP Address Validation can help provide instant location verification to websites or data enhancement to contact lists.

Developer Guide

• Operations
  • This section lists the DOTS IP Address Validation operations and goes into the details behind the inputs and outputs. 
    • Operations:
    • GetGeoLocationByIP_V4 (Recommend Operation)
    • GetCountryByIP
    • GetLocationByIP  (Deprecated) 
    • GetLocationByIP_V2  (Deprecated) 
    • GetGeoLocationByIP_V3  (Deprecated) 
• Codes and Notes
  • This section shows additional supporting data tables that are associated to the DOTS IP Address Validation operations.
• Errors
  • Similar to  the Codes and Notes section, 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 GetGeoLocationByIP_V4.
• 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 IP Address Validation 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.
• IP Address Validation is a public XML web service that supports SOAP, POST and GET operations.

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

• 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/gpp/soap.svc?wsdl

• Service XML Request Help Page
• https://trial.serviceobjects.com/gpp/web.svc/xml/help

• Service JSON Request Help Page
• https://trial.serviceobjects.com/gpp/web.svc/json/help

• This WSDL is the definition of the web service, defining its inputs, outputs, operations, etc. You will most likely have a tool read this WSDL and make the operations available to you in your application. Whenever your utilities or IDE asks for a WSDL path to IP Address Validation, you can provide the above path.
• 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.