10:49 Friday 19th September 2014
|Welcome||Pro League||Tipzone API||API Manual||How to join||Apply|
Along with the SOAP API, all subscribbed API members recieve an RSS feed of thier tips. This can be accessed using the following URL.
The Pro API service is provided via a SOAP interface, the details of which are as follows.
Service location: http://www.gg.com/tipzone/pro/api/api.php
WSDL location: http://www.gg.com/tipzone/pro/api/api.wsdl
Access to this service is restricted to those tipsters that have registered as a professional tipsters and subscribed to the Pro API service.
To help you get started, please find bellow some example code that connects to the Pro service and returns the sports active for today.
This example has been coded in PHP 5.1 and is only intended to provide you with an idea of how to connect to the service. If you need to access the service using a different language, then please create your own code to do this.
To allow you to test the service's connectivity and begin your integration, there is a test mode available that can be accessed by passing a switch into the login function. This switch should be set too 'true' to activate the test mode and left off completely or set to false otherwise.
When using test mode, all reading operations will operate identically, but the place_tip function will, instead of placing your tip, simply validate the data provided and return a dummy tip record if all is valid.
Functions within this service will always return the following in addition to any function specific return data:
function login(email: String, password: String, testMode: Boolean = false)
Your first command in any connection should be to login. This will authenticate you with the server and will remain valid for the duration of that one connection.
function get_sport(date: Unix Timestamp = Now()) return sports: array( item: sport )
This will return an array of sports that are currently active on GG.COM at the time specified in 'date'. If no date is given, then the current date is used.
function get_venues(sportID: Unsigned Integer) return venues: array( item: venue )
This function will return a list of venues in which events are active for the sport provided.
function get_events(venueID: Unsigned Integer) return events: array( item: event )
This function will return a list of events for the venue provided.
Event statuses include:
function get_outcomes(eventID: Unsigned Integer) return outcomes: array( item: outcome )
This function will return a list of all the possible outcomes for the event provided.
function get_tips(tipStatus: Unsigned Integer, date: Unix Timestamp) return tips: array( item: tip )
This function will return a list of all the tips on your account by status for a particular date.
Tip statuses include:
function place_tip(outcomeID: Unsigned Integer, stake: Unsigned Integer, eachWay: Unsigned Integer, atSP: Unsigned Integer, reason: String = '') return tip: tip
This function will place a tip on the outcome specified by 'outcomeID'. The values required by this function should be provided as follow: