CardService

URL: http://landgrab.net/landgrab/services/LogService
WSDL: http://landgrab.net/landgrab/services/LogService?wsdl

The LogService has methods for retrieving log entries for a given game.

Methods

getAllLogs(sessionKey, gameNumber)

Arguments:
sessionKey (xsd:string) The session key obtained from the initiateSession call
gameNumber (xsd:int) The game number

Returns
: an array of LogSoapBean objects

This method returns all log entries for the given game number. Note: you cannot retrieve any logs for a game if the game is still in "initial placement mode". You will receive an exception if you try to retrieve any logs for a game that is still in initial placement mode.


getLogsForTurn(sessionKey, gameNumber, turnNumber)

Arguments:
sessionKey (xsd:string) The session key obtained from the initiateSession call
gameNumber (xsd:int) The game number
turnNumber (xsd:int) The turn number

Returns: An array of LogSoapBean objects

This method returns the log entries for a given turn number in the specified game. Note: you cannot retrieve any logs for a game if the game is still in "initial placement mode". You will receive an exception if you try to retrieve any logs for a game that is still in initial placement mode.

 

getLogsByType(sessionKey, gameNumber, logEntryTypes)

Arguments:
sessionKey (xsd:string) The session key obtained from the initiateSession call
gameNumber (xsd:int) The game number
logEntryTypes (xsd:int[]) An array of integers specifying the log entry type

Returns
: an array of LogSoapBean objects

This method returns all log entries for the given game number which are of the given entry type(s). You can specify multiple entry types in the array. Consult the logsoapbean for possible types. Note: you cannot retrieve any logs for a game if the game is still in "initial placement mode". You will receive an exception if you try to retrieve any logs for a game that is still in initial placement mode.


 

getLogsSince(sessionKey, gameNumber, date)

Arguments:
sessionKey (xsd:string) The session key obtained from the initiateSession call
gameNumber (xsd:int) The game number
date (xsd:dateTime) An ISO 8601 datetime string

Returns
: an array of LogSoapBean objects

This method returns all log entries for the given game number which were recorded after the given date. Some examples of possible RFC 8601 date time strings: 2001-10-26T21:32:52, 2001-10-26T21:32:52+02:00, 2001-10-26T19:32:52Z, 2001-10-26T19:32:52+00:00, -2001-10-26T21:32:52, or 2001-10-26T21:32:52.12679

 


 

getLogsSinceID(sessionKey, gameNumber, logID)

Arguments:
sessionKey (xsd:string) The session key obtained from the initiateSession call
gameNumber (xsd:int) The game number
logID (xsd:long) A log ID (id from the LogSoapBean)


Returns
: an array of LogSoapBean objects

This method returns all log entries for the given game number which were recorded after the given log ID.