AT AppointmentTrader
Accedi
Online ora  

/v1/auth/

Auth session management endpoints for native v2 account surfaces. Email-code and Google-state initiation are public by design. Session-management endpoints are authenticated-only. They expose the viewer's active browser sessions, allow a user to remove one session, remove every other session, or remove all sessions. Removing the current browser session clears the current browser session cookie and returns signedOut=true so native v2 clients can hard-navigate into the logged-out shell.
GET

/v1/auth/get_sessions

#
Return the authenticated user's active sessions, with the current browser session marked for display on the native v2 Session Manager.
Esempio di richiesta (cURL) 
curl --get \
  'https://it.appointmenttrader.com/v1/auth/get_sessions' \
  --data-urlencode 'key={{API_KEY}}'

Risposta

JSON
See the shared response schema and synthetic example.
Campi della risposta
CampoTipoObbligatorioDescrizione
$auth_get_sessions_Response Sì
$.oneOf[0] Sì
$.oneOf[0].allOf[0]object Sì
$.oneOf[0].allOf[0].RequestUserAliasstring Sì
$.oneOf[0].allOf[0].RequestPathstring | null Sì
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" Sì
$.oneOf[0].allOf[0].ResponseCodeinteger Sì
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage Sì
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null Sì
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array Sì
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage No
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object Sì
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage No
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring No
$.oneOf[0].allOf[1]object Sì
$.oneOf[0].allOf[1].Payloadobject Sì
$.oneOf[0].allOf[1].Payload.sessionsarray Sì
$.oneOf[0].allOf[1].Payload.sessions[]object No
$.oneOf[0].allOf[1].Payload.sessions[].sessionIDstring Sì
$.oneOf[0].allOf[1].Payload.sessions[].createdDatestring Sì
$.oneOf[0].allOf[1].Payload.sessions[].createdLabelstring Sì
$.oneOf[0].allOf[1].Payload.sessions[].lastActivityDatestring Sì
$.oneOf[0].allOf[1].Payload.sessions[].lastActivityLabelstring Sì
$.oneOf[0].allOf[1].Payload.sessions[].ipstring Sì
$.oneOf[0].allOf[1].Payload.sessions[].citystring Sì
$.oneOf[0].allOf[1].Payload.sessions[].countrystring Sì
$.oneOf[0].allOf[1].Payload.sessions[].locationLabelstring Sì
$.oneOf[0].allOf[1].Payload.sessions[].deviceLabelstring Sì
$.oneOf[0].allOf[1].Payload.sessions[].browserLabelstring Sì
$.oneOf[0].allOf[1].Payload.sessions[].agentstring Sì
$.oneOf[0].allOf[1].Payload.sessions[].lastOriginstring Sì
$.oneOf[0].allOf[1].Payload.sessions[].releaseVersionstring Sì
$.oneOf[0].allOf[1].Payload.sessions[].buildModestring Sì
$.oneOf[0].allOf[1].Payload.sessions[].clientTypestring Sì
$.oneOf[0].allOf[1].Payload.sessions[].isCurrentboolean Sì
$.oneOf[0].allOf[1].Payload.sessions[].isAlternativePortalSessionboolean Sì
$.oneOf[0].allOf[1].Payload.currentSession Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0]object Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].sessionIDstring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].createdDatestring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].createdLabelstring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].lastActivityDatestring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].lastActivityLabelstring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].ipstring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].citystring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].countrystring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].locationLabelstring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].deviceLabelstring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].browserLabelstring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].agentstring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].lastOriginstring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].releaseVersionstring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].buildModestring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].clientTypestring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].isCurrentboolean Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].isAlternativePortalSessionboolean Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[1]null Sì
$.oneOf[0].allOf[1].Payload.otherSessionsarray Sì
$.oneOf[0].allOf[1].Payload.otherSessions[]object No
$.oneOf[0].allOf[1].Payload.otherSessions[].sessionIDstring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].createdDatestring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].createdLabelstring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].lastActivityDatestring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].lastActivityLabelstring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].ipstring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].citystring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].countrystring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].locationLabelstring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].deviceLabelstring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].browserLabelstring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].agentstring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].lastOriginstring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].releaseVersionstring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].buildModestring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].clientTypestring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].isCurrentboolean Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].isAlternativePortalSessionboolean Sì
$.oneOf[0].allOf[1].Payload.currentSessionIDstring Sì
$.oneOf[0].allOf[1].Payload.otherSessionCountinteger Sì
$.oneOf[0].allOf[1].Payload.signedOutboolean Sì
$.oneOf[0].allOf[1].Payload.redirectUrlstring Sì
$.oneOf[1]object Sì
$.oneOf[1].RequestUserAliasstring Sì
$.oneOf[1].RequestPathstring | null Sì
$.oneOf[1].RequestStatus = "Failed" Sì
$.oneOf[1].ResponseCodeinteger Sì
$.oneOf[1].ResponseMessageAPIResponseMessage Sì
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null Sì
$.oneOf[1].ResponseMessage.oneOf[1]array Sì
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage No
$.oneOf[1].ResponseMessage.oneOf[2]object Sì
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage No
$.oneOf[1].RequestImpersonatedByUserAliasstring No
Esempio di risposta 
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/auth/get_sessions",
    "RequestUserAlias": "example-user",
    "Payload": {
        "sessions": [],
        "currentSession": {
            "sessionID": "synthetic-example",
            "createdDate": "synthetic-example",
            "createdLabel": "synthetic-example",
            "lastActivityDate": "synthetic-example",
            "lastActivityLabel": "synthetic-example",
            "ip": "synthetic-example",
            "city": "synthetic-example",
            "country": "synthetic-example",
            "locationLabel": "synthetic-example",
            "deviceLabel": "synthetic-example",
            "browserLabel": "synthetic-example",
            "agent": "synthetic-example",
            "lastOrigin": "synthetic-example",
            "releaseVersion": "synthetic-example",
            "buildMode": "synthetic-example",
            "clientType": "synthetic-example",
            "isCurrent": false,
            "isAlternativePortalSession": false
        },
        "otherSessions": [],
        "currentSessionID": "synthetic-example",
        "otherSessionCount": 0,
        "signedOut": false,
        "redirectUrl": "synthetic-example"
    }
}
Documentazione dell’endpoint leggibile dalle macchine
POST

/v1/auth/set_all_sessions_removed

#
Remove every active session owned by the authenticated user, including the current browser session. The browser cookie is expired and the response includes signedOut=true.

Parametri

NomeTipoObbligatorioPredefinitoDescrizione
isWritingRequest bool No false Set true to actually remove all sessions.
Esempio di richiesta (cURL) 
curl --request POST \
  'https://it.appointmenttrader.com/v1/auth/set_all_sessions_removed' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

Risposta

JSON
See the shared response schema and synthetic example.
Campi della risposta
CampoTipoObbligatorioDescrizione
$auth_set_all_sessions_removed_Response Sì
$.oneOf[0] Sì
$.oneOf[0].allOf[0]object Sì
$.oneOf[0].allOf[0].RequestUserAliasstring Sì
$.oneOf[0].allOf[0].RequestPathstring | null Sì
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" Sì
$.oneOf[0].allOf[0].ResponseCodeinteger Sì
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage Sì
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null Sì
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array Sì
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage No
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object Sì
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage No
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring No
$.oneOf[0].allOf[1]object Sì
$.oneOf[0].allOf[1].Payloadobject Sì
$.oneOf[0].allOf[1].Payload.sessionsarray Sì
$.oneOf[0].allOf[1].Payload.sessions[]object No
$.oneOf[0].allOf[1].Payload.sessions[].sessionIDstring Sì
$.oneOf[0].allOf[1].Payload.sessions[].createdDatestring Sì
$.oneOf[0].allOf[1].Payload.sessions[].createdLabelstring Sì
$.oneOf[0].allOf[1].Payload.sessions[].lastActivityDatestring Sì
$.oneOf[0].allOf[1].Payload.sessions[].lastActivityLabelstring Sì
$.oneOf[0].allOf[1].Payload.sessions[].ipstring Sì
$.oneOf[0].allOf[1].Payload.sessions[].citystring Sì
$.oneOf[0].allOf[1].Payload.sessions[].countrystring Sì
$.oneOf[0].allOf[1].Payload.sessions[].locationLabelstring Sì
$.oneOf[0].allOf[1].Payload.sessions[].deviceLabelstring Sì
$.oneOf[0].allOf[1].Payload.sessions[].browserLabelstring Sì
$.oneOf[0].allOf[1].Payload.sessions[].agentstring Sì
$.oneOf[0].allOf[1].Payload.sessions[].lastOriginstring Sì
$.oneOf[0].allOf[1].Payload.sessions[].releaseVersionstring Sì
$.oneOf[0].allOf[1].Payload.sessions[].buildModestring Sì
$.oneOf[0].allOf[1].Payload.sessions[].clientTypestring Sì
$.oneOf[0].allOf[1].Payload.sessions[].isCurrentboolean Sì
$.oneOf[0].allOf[1].Payload.sessions[].isAlternativePortalSessionboolean Sì
$.oneOf[0].allOf[1].Payload.currentSession Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0]object Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].sessionIDstring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].createdDatestring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].createdLabelstring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].lastActivityDatestring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].lastActivityLabelstring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].ipstring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].citystring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].countrystring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].locationLabelstring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].deviceLabelstring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].browserLabelstring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].agentstring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].lastOriginstring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].releaseVersionstring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].buildModestring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].clientTypestring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].isCurrentboolean Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].isAlternativePortalSessionboolean Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[1]null Sì
$.oneOf[0].allOf[1].Payload.otherSessionsarray Sì
$.oneOf[0].allOf[1].Payload.otherSessions[]object No
$.oneOf[0].allOf[1].Payload.otherSessions[].sessionIDstring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].createdDatestring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].createdLabelstring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].lastActivityDatestring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].lastActivityLabelstring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].ipstring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].citystring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].countrystring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].locationLabelstring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].deviceLabelstring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].browserLabelstring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].agentstring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].lastOriginstring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].releaseVersionstring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].buildModestring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].clientTypestring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].isCurrentboolean Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].isAlternativePortalSessionboolean Sì
$.oneOf[0].allOf[1].Payload.currentSessionIDstring Sì
$.oneOf[0].allOf[1].Payload.otherSessionCountinteger Sì
$.oneOf[0].allOf[1].Payload.signedOutboolean Sì
$.oneOf[0].allOf[1].Payload.redirectUrlstring Sì
$.oneOf[1]object Sì
$.oneOf[1].RequestUserAliasstring Sì
$.oneOf[1].RequestPathstring | null Sì
$.oneOf[1].RequestStatus = "Failed" Sì
$.oneOf[1].ResponseCodeinteger Sì
$.oneOf[1].ResponseMessageAPIResponseMessage Sì
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null Sì
$.oneOf[1].ResponseMessage.oneOf[1]array Sì
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage No
$.oneOf[1].ResponseMessage.oneOf[2]object Sì
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage No
$.oneOf[1].RequestImpersonatedByUserAliasstring No
Esempio di risposta 
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/auth/set_all_sessions_removed",
    "RequestUserAlias": "example-user",
    "Payload": {
        "sessions": [],
        "currentSession": {
            "sessionID": "synthetic-example",
            "createdDate": "synthetic-example",
            "createdLabel": "synthetic-example",
            "lastActivityDate": "synthetic-example",
            "lastActivityLabel": "synthetic-example",
            "ip": "synthetic-example",
            "city": "synthetic-example",
            "country": "synthetic-example",
            "locationLabel": "synthetic-example",
            "deviceLabel": "synthetic-example",
            "browserLabel": "synthetic-example",
            "agent": "synthetic-example",
            "lastOrigin": "synthetic-example",
            "releaseVersion": "synthetic-example",
            "buildMode": "synthetic-example",
            "clientType": "synthetic-example",
            "isCurrent": false,
            "isAlternativePortalSession": false
        },
        "otherSessions": [],
        "currentSessionID": "synthetic-example",
        "otherSessionCount": 0,
        "signedOut": false,
        "redirectUrl": "synthetic-example"
    }
}
Documentazione dell’endpoint leggibile dalle macchine
POST

/v1/auth/set_google_oauth_state

#
Create signed Google OAuth state, including optional signup-page context. Public-by-design: anonymous users must be able to begin Google authentication.

Parametri

NomeTipoObbligatorioPredefinitoDescrizione
signupContext string No "" Optional base64 JSON {path,locationID,capturedAt}; capturedAt is Unix seconds.
isWritingRequest bool No false Set true to issue state and its anti-CSRF cookie.
Esempio di richiesta (cURL) 
curl --request POST \
  'https://it.appointmenttrader.com/v1/auth/set_google_oauth_state' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'signupContext={{signupContext}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

Risposta

JSON
See the shared response schema and synthetic example.
Parametri: signupContext
CampoTipoObbligatorioDescrizione
signupContextstring (application/json) No
signupContextobject (JSON decodificato) No
signupContext.pathstring Sì
signupContext.locationIDDatabaseInteger NoInteger value; legacy MySQL reads may serialize it as a numeric string.
signupContext.locationID.oneOf[0]integer No
signupContext.locationID.oneOf[1]string No
signupContext.capturedAtDatabaseInteger NoInteger value; legacy MySQL reads may serialize it as a numeric string.
signupContext.capturedAt.oneOf[0]integer No
signupContext.capturedAt.oneOf[1]string No
Campi della risposta
CampoTipoObbligatorioDescrizione
$auth_set_google_oauth_state_Response Sì
$.oneOf[0] Sì
$.oneOf[0].allOf[0]object Sì
$.oneOf[0].allOf[0].RequestUserAliasstring Sì
$.oneOf[0].allOf[0].RequestPathstring | null Sì
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" Sì
$.oneOf[0].allOf[0].ResponseCodeinteger Sì
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage Sì
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null Sì
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array Sì
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage No
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object Sì
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage No
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring No
$.oneOf[0].allOf[1]object Sì
$.oneOf[0].allOf[1].Payload Sì
$.oneOf[0].allOf[1].Payload.oneOf[0]object Sì
$.oneOf[0].allOf[1].Payload.oneOf[0].State = "Success" Sì
$.oneOf[0].allOf[1].Payload.oneOf[0].Payloadstring Sì
$.oneOf[0].allOf[1].Payload.oneOf[1]object Sì
$.oneOf[0].allOf[1].Payload.oneOf[1].State = "Failed" Sì
$.oneOf[0].allOf[1].Payload.oneOf[1].ErrorMessagestring Sì
$.oneOf[1]object Sì
$.oneOf[1].RequestUserAliasstring Sì
$.oneOf[1].RequestPathstring | null Sì
$.oneOf[1].RequestStatus = "Failed" Sì
$.oneOf[1].ResponseCodeinteger Sì
$.oneOf[1].ResponseMessageAPIResponseMessage Sì
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null Sì
$.oneOf[1].ResponseMessage.oneOf[1]array Sì
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage No
$.oneOf[1].ResponseMessage.oneOf[2]object Sì
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage No
$.oneOf[1].RequestImpersonatedByUserAliasstring No
Esempio di risposta 
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/auth/set_google_oauth_state",
    "RequestUserAlias": "example-user",
    "Payload": {
        "State": "Success",
        "Payload": "synthetic-example"
    }
}
Documentazione dell’endpoint leggibile dalle macchine
POST

/v1/auth/set_other_sessions_removed

#
Remove every active session except the current browser session. The viewer remains signed in on this device and receives a refreshed list.

Parametri

NomeTipoObbligatorioPredefinitoDescrizione
isWritingRequest bool No false Set true to actually remove other sessions.
Esempio di richiesta (cURL) 
curl --request POST \
  'https://it.appointmenttrader.com/v1/auth/set_other_sessions_removed' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

Risposta

JSON
See the shared response schema and synthetic example.
Campi della risposta
CampoTipoObbligatorioDescrizione
$auth_set_other_sessions_removed_Response Sì
$.oneOf[0] Sì
$.oneOf[0].allOf[0]object Sì
$.oneOf[0].allOf[0].RequestUserAliasstring Sì
$.oneOf[0].allOf[0].RequestPathstring | null Sì
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" Sì
$.oneOf[0].allOf[0].ResponseCodeinteger Sì
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage Sì
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null Sì
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array Sì
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage No
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object Sì
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage No
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring No
$.oneOf[0].allOf[1]object Sì
$.oneOf[0].allOf[1].Payloadobject Sì
$.oneOf[0].allOf[1].Payload.sessionsarray Sì
$.oneOf[0].allOf[1].Payload.sessions[]object No
$.oneOf[0].allOf[1].Payload.sessions[].sessionIDstring Sì
$.oneOf[0].allOf[1].Payload.sessions[].createdDatestring Sì
$.oneOf[0].allOf[1].Payload.sessions[].createdLabelstring Sì
$.oneOf[0].allOf[1].Payload.sessions[].lastActivityDatestring Sì
$.oneOf[0].allOf[1].Payload.sessions[].lastActivityLabelstring Sì
$.oneOf[0].allOf[1].Payload.sessions[].ipstring Sì
$.oneOf[0].allOf[1].Payload.sessions[].citystring Sì
$.oneOf[0].allOf[1].Payload.sessions[].countrystring Sì
$.oneOf[0].allOf[1].Payload.sessions[].locationLabelstring Sì
$.oneOf[0].allOf[1].Payload.sessions[].deviceLabelstring Sì
$.oneOf[0].allOf[1].Payload.sessions[].browserLabelstring Sì
$.oneOf[0].allOf[1].Payload.sessions[].agentstring Sì
$.oneOf[0].allOf[1].Payload.sessions[].lastOriginstring Sì
$.oneOf[0].allOf[1].Payload.sessions[].releaseVersionstring Sì
$.oneOf[0].allOf[1].Payload.sessions[].buildModestring Sì
$.oneOf[0].allOf[1].Payload.sessions[].clientTypestring Sì
$.oneOf[0].allOf[1].Payload.sessions[].isCurrentboolean Sì
$.oneOf[0].allOf[1].Payload.sessions[].isAlternativePortalSessionboolean Sì
$.oneOf[0].allOf[1].Payload.currentSession Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0]object Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].sessionIDstring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].createdDatestring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].createdLabelstring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].lastActivityDatestring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].lastActivityLabelstring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].ipstring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].citystring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].countrystring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].locationLabelstring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].deviceLabelstring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].browserLabelstring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].agentstring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].lastOriginstring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].releaseVersionstring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].buildModestring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].clientTypestring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].isCurrentboolean Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].isAlternativePortalSessionboolean Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[1]null Sì
$.oneOf[0].allOf[1].Payload.otherSessionsarray Sì
$.oneOf[0].allOf[1].Payload.otherSessions[]object No
$.oneOf[0].allOf[1].Payload.otherSessions[].sessionIDstring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].createdDatestring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].createdLabelstring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].lastActivityDatestring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].lastActivityLabelstring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].ipstring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].citystring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].countrystring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].locationLabelstring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].deviceLabelstring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].browserLabelstring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].agentstring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].lastOriginstring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].releaseVersionstring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].buildModestring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].clientTypestring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].isCurrentboolean Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].isAlternativePortalSessionboolean Sì
$.oneOf[0].allOf[1].Payload.currentSessionIDstring Sì
$.oneOf[0].allOf[1].Payload.otherSessionCountinteger Sì
$.oneOf[0].allOf[1].Payload.signedOutboolean Sì
$.oneOf[0].allOf[1].Payload.redirectUrlstring Sì
$.oneOf[1]object Sì
$.oneOf[1].RequestUserAliasstring Sì
$.oneOf[1].RequestPathstring | null Sì
$.oneOf[1].RequestStatus = "Failed" Sì
$.oneOf[1].ResponseCodeinteger Sì
$.oneOf[1].ResponseMessageAPIResponseMessage Sì
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null Sì
$.oneOf[1].ResponseMessage.oneOf[1]array Sì
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage No
$.oneOf[1].ResponseMessage.oneOf[2]object Sì
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage No
$.oneOf[1].RequestImpersonatedByUserAliasstring No
Esempio di risposta 
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/auth/set_other_sessions_removed",
    "RequestUserAlias": "example-user",
    "Payload": {
        "sessions": [],
        "currentSession": {
            "sessionID": "synthetic-example",
            "createdDate": "synthetic-example",
            "createdLabel": "synthetic-example",
            "lastActivityDate": "synthetic-example",
            "lastActivityLabel": "synthetic-example",
            "ip": "synthetic-example",
            "city": "synthetic-example",
            "country": "synthetic-example",
            "locationLabel": "synthetic-example",
            "deviceLabel": "synthetic-example",
            "browserLabel": "synthetic-example",
            "agent": "synthetic-example",
            "lastOrigin": "synthetic-example",
            "releaseVersion": "synthetic-example",
            "buildMode": "synthetic-example",
            "clientType": "synthetic-example",
            "isCurrent": false,
            "isAlternativePortalSession": false
        },
        "otherSessions": [],
        "currentSessionID": "synthetic-example",
        "otherSessionCount": 0,
        "signedOut": false,
        "redirectUrl": "synthetic-example"
    }
}
Documentazione dell’endpoint leggibile dalle macchine
POST

/v1/auth/set_send_login_code

#
Send an email login code using the existing authentication flow. A new account retains optional signup-page context independently from its post-login return destination. Public-by-design: anonymous users must be able to begin email authentication.

Parametri

NomeTipoObbligatorioPredefinitoDescrizione
email string Sì — Email address to authenticate.
origin string No "Sign in" Existing auth action label.
originalRequest string No "" Base64-encoded post-login return URL.
signupContext string No "" Optional base64 JSON {path,locationID,capturedAt}; capturedAt is Unix seconds.
isWritingRequest bool No false Set true to send the code.
Esempio di richiesta (cURL) 
curl --request POST \
  'https://it.appointmenttrader.com/v1/auth/set_send_login_code' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'email={{email}}' \
  --data-urlencode 'origin={{origin}}' \
  --data-urlencode 'originalRequest={{originalRequest}}' \
  --data-urlencode 'signupContext={{signupContext}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

Risposta

JSON
See the shared response schema and synthetic example.
Parametri: signupContext
CampoTipoObbligatorioDescrizione
signupContextstring (application/json) No
signupContextobject (JSON decodificato) No
signupContext.pathstring Sì
signupContext.locationIDDatabaseInteger NoInteger value; legacy MySQL reads may serialize it as a numeric string.
signupContext.locationID.oneOf[0]integer No
signupContext.locationID.oneOf[1]string No
signupContext.capturedAtDatabaseInteger NoInteger value; legacy MySQL reads may serialize it as a numeric string.
signupContext.capturedAt.oneOf[0]integer No
signupContext.capturedAt.oneOf[1]string No
Campi della risposta
CampoTipoObbligatorioDescrizione
$auth_set_send_login_code_Response Sì
$.oneOf[0] Sì
$.oneOf[0].allOf[0]object Sì
$.oneOf[0].allOf[0].RequestUserAliasstring Sì
$.oneOf[0].allOf[0].RequestPathstring | null Sì
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" Sì
$.oneOf[0].allOf[0].ResponseCodeinteger Sì
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage Sì
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null Sì
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array Sì
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage No
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object Sì
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage No
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring No
$.oneOf[0].allOf[1]object Sì
$.oneOf[0].allOf[1].Payload Sì
$.oneOf[0].allOf[1].Payload.oneOf[0]object Sì
$.oneOf[0].allOf[1].Payload.oneOf[0].State = "Success" Sì
$.oneOf[0].allOf[1].Payload.oneOf[0].URLstring Sì
$.oneOf[0].allOf[1].Payload.oneOf[1]object Sì
$.oneOf[0].allOf[1].Payload.oneOf[1].State = "Failed" Sì
$.oneOf[0].allOf[1].Payload.oneOf[1].ErrorMessagestring Sì
$.oneOf[1]object Sì
$.oneOf[1].RequestUserAliasstring Sì
$.oneOf[1].RequestPathstring | null Sì
$.oneOf[1].RequestStatus = "Failed" Sì
$.oneOf[1].ResponseCodeinteger Sì
$.oneOf[1].ResponseMessageAPIResponseMessage Sì
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null Sì
$.oneOf[1].ResponseMessage.oneOf[1]array Sì
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage No
$.oneOf[1].ResponseMessage.oneOf[2]object Sì
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage No
$.oneOf[1].RequestImpersonatedByUserAliasstring No
$.oneOf[2]object SìLegacy authenticate.php exits directly after a checkout email-binding failure, before CallLegacyEndpoint can wrap this JSON.
$.oneOf[2].State = "Failed" Sì
$.oneOf[2].ErrorMessagestring Sì
Esempio di risposta 
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/auth/set_send_login_code",
    "RequestUserAlias": "example-user",
    "Payload": {
        "State": "Success",
        "URL": "synthetic-example"
    }
}
Documentazione dell’endpoint leggibile dalle macchine
POST

/v1/auth/set_session_removed

#
Remove one active session owned by the authenticated user. If that session is the current browser session, the browser cookie is expired and the response includes signedOut=true.

Parametri

NomeTipoObbligatorioPredefinitoDescrizione
sessionID string Sì — Session token returned by get_sessions.
isWritingRequest bool No false Set true to actually remove the session.
Esempio di richiesta (cURL) 
curl --request POST \
  'https://it.appointmenttrader.com/v1/auth/set_session_removed' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'sessionID={{sessionID}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

Risposta

JSON
See the shared response schema and synthetic example.
Campi della risposta
CampoTipoObbligatorioDescrizione
$auth_set_session_removed_Response Sì
$.oneOf[0] Sì
$.oneOf[0].allOf[0]object Sì
$.oneOf[0].allOf[0].RequestUserAliasstring Sì
$.oneOf[0].allOf[0].RequestPathstring | null Sì
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" Sì
$.oneOf[0].allOf[0].ResponseCodeinteger Sì
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage Sì
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null Sì
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array Sì
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage No
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object Sì
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage No
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring No
$.oneOf[0].allOf[1]object Sì
$.oneOf[0].allOf[1].Payloadobject Sì
$.oneOf[0].allOf[1].Payload.sessionsarray Sì
$.oneOf[0].allOf[1].Payload.sessions[]object No
$.oneOf[0].allOf[1].Payload.sessions[].sessionIDstring Sì
$.oneOf[0].allOf[1].Payload.sessions[].createdDatestring Sì
$.oneOf[0].allOf[1].Payload.sessions[].createdLabelstring Sì
$.oneOf[0].allOf[1].Payload.sessions[].lastActivityDatestring Sì
$.oneOf[0].allOf[1].Payload.sessions[].lastActivityLabelstring Sì
$.oneOf[0].allOf[1].Payload.sessions[].ipstring Sì
$.oneOf[0].allOf[1].Payload.sessions[].citystring Sì
$.oneOf[0].allOf[1].Payload.sessions[].countrystring Sì
$.oneOf[0].allOf[1].Payload.sessions[].locationLabelstring Sì
$.oneOf[0].allOf[1].Payload.sessions[].deviceLabelstring Sì
$.oneOf[0].allOf[1].Payload.sessions[].browserLabelstring Sì
$.oneOf[0].allOf[1].Payload.sessions[].agentstring Sì
$.oneOf[0].allOf[1].Payload.sessions[].lastOriginstring Sì
$.oneOf[0].allOf[1].Payload.sessions[].releaseVersionstring Sì
$.oneOf[0].allOf[1].Payload.sessions[].buildModestring Sì
$.oneOf[0].allOf[1].Payload.sessions[].clientTypestring Sì
$.oneOf[0].allOf[1].Payload.sessions[].isCurrentboolean Sì
$.oneOf[0].allOf[1].Payload.sessions[].isAlternativePortalSessionboolean Sì
$.oneOf[0].allOf[1].Payload.currentSession Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0]object Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].sessionIDstring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].createdDatestring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].createdLabelstring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].lastActivityDatestring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].lastActivityLabelstring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].ipstring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].citystring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].countrystring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].locationLabelstring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].deviceLabelstring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].browserLabelstring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].agentstring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].lastOriginstring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].releaseVersionstring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].buildModestring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].clientTypestring Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].isCurrentboolean Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[0].isAlternativePortalSessionboolean Sì
$.oneOf[0].allOf[1].Payload.currentSession.anyOf[1]null Sì
$.oneOf[0].allOf[1].Payload.otherSessionsarray Sì
$.oneOf[0].allOf[1].Payload.otherSessions[]object No
$.oneOf[0].allOf[1].Payload.otherSessions[].sessionIDstring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].createdDatestring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].createdLabelstring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].lastActivityDatestring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].lastActivityLabelstring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].ipstring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].citystring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].countrystring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].locationLabelstring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].deviceLabelstring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].browserLabelstring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].agentstring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].lastOriginstring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].releaseVersionstring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].buildModestring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].clientTypestring Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].isCurrentboolean Sì
$.oneOf[0].allOf[1].Payload.otherSessions[].isAlternativePortalSessionboolean Sì
$.oneOf[0].allOf[1].Payload.currentSessionIDstring Sì
$.oneOf[0].allOf[1].Payload.otherSessionCountinteger Sì
$.oneOf[0].allOf[1].Payload.signedOutboolean Sì
$.oneOf[0].allOf[1].Payload.redirectUrlstring Sì
$.oneOf[1]object Sì
$.oneOf[1].RequestUserAliasstring Sì
$.oneOf[1].RequestPathstring | null Sì
$.oneOf[1].RequestStatus = "Failed" Sì
$.oneOf[1].ResponseCodeinteger Sì
$.oneOf[1].ResponseMessageAPIResponseMessage Sì
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null Sì
$.oneOf[1].ResponseMessage.oneOf[1]array Sì
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage No
$.oneOf[1].ResponseMessage.oneOf[2]object Sì
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage No
$.oneOf[1].RequestImpersonatedByUserAliasstring No
Esempio di risposta 
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/auth/set_session_removed",
    "RequestUserAlias": "example-user",
    "Payload": {
        "sessions": [],
        "currentSession": {
            "sessionID": "synthetic-example",
            "createdDate": "synthetic-example",
            "createdLabel": "synthetic-example",
            "lastActivityDate": "synthetic-example",
            "lastActivityLabel": "synthetic-example",
            "ip": "synthetic-example",
            "city": "synthetic-example",
            "country": "synthetic-example",
            "locationLabel": "synthetic-example",
            "deviceLabel": "synthetic-example",
            "browserLabel": "synthetic-example",
            "agent": "synthetic-example",
            "lastOrigin": "synthetic-example",
            "releaseVersion": "synthetic-example",
            "buildMode": "synthetic-example",
            "clientType": "synthetic-example",
            "isCurrent": false,
            "isAlternativePortalSession": false
        },
        "otherSessions": [],
        "currentSessionID": "synthetic-example",
        "otherSessionCount": 0,
        "signedOut": false,
        "redirectUrl": "synthetic-example"
    }
}
Documentazione dell’endpoint leggibile dalle macchine