GetAgentFromTicket
From The Contingency Market
Contents |
GetAgentFromTicket(ulSessionID,uSequenceID,sIntegrity,sTicket,sCertificate)
Gets the agent's record corresponding to the ticket. Private details are only provided if the ticket agent is the one currently authenticated. A fault occurs if the certificate fails (is invalid or has expired). Certificates are valid for 24 hours.
PARAMETERS
-
ulong ulSessionID - ID of authenticated session.
-
uint uSequenceID - Sequence number.
-
string sIntegrity -
md5("ipaddr(sid,seq)->GetAgentFromTicket(sTicket,sCertificate)/secret"). -
string sTicket - Universally unique string identifying a previously authenticated agent and an action.
-
string sCertificate - Corresponding string certifying ticket was issued by the identified agent.
RETURNS
{sID,sDisplayName,sRegistered,sPublicDetails,uVerificationLevel,sPrivateDetails}
-
string sID - 32 digit hex representing Agent's globally unique id.
-
string sDisplayName - Agent's display name.
-
string sRegistered - yyyy-mm-dd HH:mm:ss (date Agent registered).
-
string sPublicDetails - PHP assoc array (list of name/value pairs) of miscellaneous Agent info.
-
string uVerificationLevel - 0 if unverified, 1 if agent's e-mail verified.
-
string sPrivateDetails - PHP assoc array of private info (only if UID is this session's authenticated agent).
FAULTS
Session. Invalid Certificate.
