מחוברים עכשיו  

/v1/external_messaging/

External Messaging Channel-neutral outbound messaging control plane. Phase one supports email, with shared identities, billing, events, suppressions, and delivery health designed for future channels such as SMS or WhatsApp.
GET

/v1/external_messaging/get_billing_settings

#
Returns billing settings and the selected default AT funding account.

פרמטרים

שםסוגחובהברירת מחדלתיאור
channel string לא "all" Billing channel. Use all for the default setting.
דוגמת בקשה (cURL)
curl --get \
  'https://he.appointmenttrader.com/v1/external_messaging/get_billing_settings' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'channel={{channel}}'

ערך מוחזר

JSON
See the shared response schema and synthetic example.
שדות התגובה
שדהסוגחובהתיאור
$external_messaging_get_billing_settings_Response כן
$.oneOf[0] כן
$.oneOf[0].allOf[0]object כן
$.oneOf[0].allOf[0].RequestUserAliasstring כן
$.oneOf[0].allOf[0].RequestPathstring | null כן
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" כן
$.oneOf[0].allOf[0].ResponseCodeinteger כן
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage לא
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage לא
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring לא
$.oneOf[0].allOf[1]object כן
$.oneOf[0].allOf[1].Payloadobject כן
$.oneOf[0].allOf[1].Payload.IDDatabaseInteger לאInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.ID.oneOf[0]integer לא
$.oneOf[0].allOf[1].Payload.ID.oneOf[1]string לא
$.oneOf[0].allOf[1].Payload.CreatedDatestring לא
$.oneOf[0].allOf[1].Payload.LastUpdateDatestring לא
$.oneOf[0].allOf[1].Payload.DeletedDate לא
$.oneOf[0].allOf[1].Payload.DeletedDate.anyOf[0]string לא
$.oneOf[0].allOf[1].Payload.DeletedDate.anyOf[1]null לא
$.oneOf[0].allOf[1].Payload.ATUser_IDDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.ATUser_ID.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.ATUser_ID.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.Channelstring כן
$.oneOf[0].allOf[1].Payload.DefaultFunding-ATAccounts_ID כן
$.oneOf[0].allOf[1].Payload.DefaultFunding-ATAccounts_ID.anyOf[0]DatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.DefaultFunding-ATAccounts_ID.anyOf[0].oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.DefaultFunding-ATAccounts_ID.anyOf[0].oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.DefaultFunding-ATAccounts_ID.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.LastSetBy-ATUser_ID לא
$.oneOf[0].allOf[1].Payload.LastSetBy-ATUser_ID.anyOf[0]DatabaseInteger לאInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.LastSetBy-ATUser_ID.anyOf[0].oneOf[0]integer לא
$.oneOf[0].allOf[1].Payload.LastSetBy-ATUser_ID.anyOf[0].oneOf[1]string לא
$.oneOf[0].allOf[1].Payload.LastSetBy-ATUser_ID.anyOf[1]null לא
$.oneOf[0].allOf[1].Payload.DefaultFundingAccount כן
$.oneOf[0].allOf[1].Payload.DefaultFundingAccount.anyOf[0]object כן
$.oneOf[0].allOf[1].Payload.DefaultFundingAccount.anyOf[0].Currencystring כן
$.oneOf[0].allOf[1].Payload.DefaultFundingAccount.anyOf[0].CurrencySymbolstring כן
$.oneOf[0].allOf[1].Payload.DefaultFundingAccount.anyOf[0].CreatedDatestring כן
$.oneOf[0].allOf[1].Payload.DefaultFundingAccount.anyOf[0].LastUpdateDatestring כן
$.oneOf[0].allOf[1].Payload.DefaultFundingAccount.anyOf[0].Namestring כן
$.oneOf[0].allOf[1].Payload.DefaultFundingAccount.anyOf[0].Descriptionstring כן
$.oneOf[0].allOf[1].Payload.DefaultFundingAccount.anyOf[0].IDDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.DefaultFundingAccount.anyOf[0].ID.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.DefaultFundingAccount.anyOf[0].ID.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.DefaultFundingAccount.anyOf[0].ATUser_IDDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.DefaultFundingAccount.anyOf[0].ATUser_ID.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.DefaultFundingAccount.anyOf[0].ATUser_ID.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.DefaultFundingAccount.anyOf[0].CurrencyCreditLimitDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.DefaultFundingAccount.anyOf[0].CurrencyCreditLimit.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.DefaultFundingAccount.anyOf[0].CurrencyCreditLimit.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.DefaultFundingAccount.anyOf[0].PayoutDefaultBasisPointsDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.DefaultFundingAccount.anyOf[0].PayoutDefaultBasisPoints.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.DefaultFundingAccount.anyOf[0].PayoutDefaultBasisPoints.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.DefaultFundingAccount.anyOf[0].PointsCreditLimitDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.DefaultFundingAccount.anyOf[0].PointsCreditLimit.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.DefaultFundingAccount.anyOf[0].PointsCreditLimit.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.DefaultFundingAccount.anyOf[0].IsATCorporateAccountDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.DefaultFundingAccount.anyOf[0].IsATCorporateAccount.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.DefaultFundingAccount.anyOf[0].IsATCorporateAccount.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.DefaultFundingAccount.anyOf[0].IsDefaultDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.DefaultFundingAccount.anyOf[0].IsDefault.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.DefaultFundingAccount.anyOf[0].IsDefault.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.DefaultFundingAccount.anyOf[0].IsDepositAccountDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.DefaultFundingAccount.anyOf[0].IsDepositAccount.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.DefaultFundingAccount.anyOf[0].IsDepositAccount.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.DefaultFundingAccount.anyOf[0].CurrencyBalanceDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.DefaultFundingAccount.anyOf[0].CurrencyBalance.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.DefaultFundingAccount.anyOf[0].CurrencyBalance.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.DefaultFundingAccount.anyOf[0].PointsBalanceDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.DefaultFundingAccount.anyOf[0].PointsBalance.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.DefaultFundingAccount.anyOf[0].PointsBalance.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.DefaultFundingAccount.anyOf[1] = false כן
$.oneOf[0].allOf[1].Payload.PriceSettingsobject כן
$.oneOf[0].allOf[1].Payload.PriceSettings.PricePerMessageinteger כן
$.oneOf[0].allOf[1].Payload.PriceSettings.PriceUnitstring ["USD","Traderpoint"] כן
$.oneOf[0].allOf[1].Payload.PriceSettings.RateLimitPerHourinteger כן
$.oneOf[0].allOf[1].Payload.PriceSettings.RecipientLimitPerMessageinteger כן
$.oneOf[1]object כן
$.oneOf[1].RequestUserAliasstring כן
$.oneOf[1].RequestPathstring | null כן
$.oneOf[1].RequestStatus = "Failed" כן
$.oneOf[1].ResponseCodeinteger כן
$.oneOf[1].ResponseMessageAPIResponseMessage כן
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null כן
$.oneOf[1].ResponseMessage.oneOf[1]array כן
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage לא
$.oneOf[1].ResponseMessage.oneOf[2]object כן
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage לא
$.oneOf[1].RequestImpersonatedByUserAliasstring לא
דוגמת תגובה
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/external_messaging/get_billing_settings",
    "RequestUserAlias": "example-user",
    "Payload": {
        "ATUser_ID": 0,
        "Channel": "synthetic-example",
        "DefaultFunding-ATAccounts_ID": 0,
        "DefaultFundingAccount": {
            "Currency": "synthetic-example",
            "CurrencySymbol": "synthetic-example",
            "CreatedDate": "synthetic-example",
            "LastUpdateDate": "synthetic-example",
            "Name": "synthetic-example",
            "Description": "synthetic-example",
            "ID": 0,
            "ATUser_ID": 0,
            "CurrencyCreditLimit": 0,
            "PayoutDefaultBasisPoints": 0,
            "PointsCreditLimit": 0,
            "IsATCorporateAccount": 0,
            "IsDefault": 0,
            "IsDepositAccount": 0,
            "CurrencyBalance": 0,
            "PointsBalance": 0
        },
        "PriceSettings": {
            "PricePerMessage": 0,
            "PriceUnit": "USD",
            "RateLimitPerHour": 0,
            "RecipientLimitPerMessage": 0
        }
    }
}
תיעוד נקודת קצה קריא למכונה
GET

/v1/external_messaging/get_channels

#
Returns supported external messaging channels.
דוגמת בקשה (cURL)
curl --get \
  'https://he.appointmenttrader.com/v1/external_messaging/get_channels' \
  --data-urlencode 'key={{API_KEY}}'

ערך מוחזר

JSON
See the shared response schema and synthetic example.
שדות התגובה
שדהסוגחובהתיאור
$external_messaging_get_channels_Response כן
$.oneOf[0] כן
$.oneOf[0].allOf[0]object כן
$.oneOf[0].allOf[0].RequestUserAliasstring כן
$.oneOf[0].allOf[0].RequestPathstring | null כן
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" כן
$.oneOf[0].allOf[0].ResponseCodeinteger כן
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage לא
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage לא
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring לא
$.oneOf[0].allOf[1]object כן
$.oneOf[0].allOf[1].Payloadobject כן
$.oneOf[0].allOf[1].Payload.channelsarray כן
$.oneOf[0].allOf[1].Payload.channels[]object לא
$.oneOf[0].allOf[1].Payload.channels[].channel = "email" כן
$.oneOf[0].allOf[1].Payload.channels[].name = "Email" כן
$.oneOf[0].allOf[1].Payload.channels[].enabled = true כן
$.oneOf[0].allOf[1].Payload.channels[].streamsarray כן
$.oneOf[0].allOf[1].Payload.channels[].streams[]string ["auth","transactional","community","bulk","sandbox"] לא
$.oneOf[0].allOf[1].Payload.priceSettingsobject כן
$.oneOf[0].allOf[1].Payload.priceSettings.PricePerMessageinteger כן
$.oneOf[0].allOf[1].Payload.priceSettings.PriceUnitstring ["USD","Traderpoint"] כן
$.oneOf[0].allOf[1].Payload.priceSettings.RateLimitPerHourinteger כן
$.oneOf[0].allOf[1].Payload.priceSettings.RecipientLimitPerMessageinteger כן
$.oneOf[1]object כן
$.oneOf[1].RequestUserAliasstring כן
$.oneOf[1].RequestPathstring | null כן
$.oneOf[1].RequestStatus = "Failed" כן
$.oneOf[1].ResponseCodeinteger כן
$.oneOf[1].ResponseMessageAPIResponseMessage כן
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null כן
$.oneOf[1].ResponseMessage.oneOf[1]array כן
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage לא
$.oneOf[1].ResponseMessage.oneOf[2]object כן
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage לא
$.oneOf[1].RequestImpersonatedByUserAliasstring לא
דוגמת תגובה
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/external_messaging/get_channels",
    "RequestUserAlias": "example-user",
    "Payload": {
        "channels": [],
        "priceSettings": {
            "PricePerMessage": 0,
            "PriceUnit": "USD",
            "RateLimitPerHour": 0,
            "RecipientLimitPerMessage": 0
        }
    }
}
תיעוד נקודת קצה קריא למכונה
GET

/v1/external_messaging/get_delivery_health

#
Returns delivery health counters for the API user.
דוגמת בקשה (cURL)
curl --get \
  'https://he.appointmenttrader.com/v1/external_messaging/get_delivery_health' \
  --data-urlencode 'key={{API_KEY}}'

ערך מוחזר

JSON
See the shared response schema and synthetic example.
שדות התגובה
שדהסוגחובהתיאור
$external_messaging_get_delivery_health_Response כן
$.oneOf[0] כן
$.oneOf[0].allOf[0]object כן
$.oneOf[0].allOf[0].RequestUserAliasstring כן
$.oneOf[0].allOf[0].RequestPathstring | null כן
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" כן
$.oneOf[0].allOf[0].ResponseCodeinteger כן
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage לא
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage לא
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring לא
$.oneOf[0].allOf[1]object כן
$.oneOf[0].allOf[1].Payloadobject כן
$.oneOf[0].allOf[1].Payload.window = "7 days" כן
$.oneOf[0].allOf[1].Payload.messageCountsobject כן
$.oneOf[0].allOf[1].Payload.messageCounts.Queuedinteger כן
$.oneOf[0].allOf[1].Payload.messageCounts.Sendinginteger כן
$.oneOf[0].allOf[1].Payload.messageCounts.Sentinteger כן
$.oneOf[0].allOf[1].Payload.messageCounts.Deferredinteger כן
$.oneOf[0].allOf[1].Payload.messageCounts.Suppressedinteger כן
$.oneOf[0].allOf[1].Payload.messageCounts.Failedinteger כן
$.oneOf[0].allOf[1].Payload.identityCounts כן
$.oneOf[0].allOf[1].Payload.identityCounts.anyOf[0]object כן
$.oneOf[0].allOf[1].Payload.identityCounts.anyOf[0].*integer לא
$.oneOf[0].allOf[1].Payload.identityCounts.anyOf[1]array כן
$.oneOf[0].allOf[1].Payload.suppressionCountinteger כן
$.oneOf[1]object כן
$.oneOf[1].RequestUserAliasstring כן
$.oneOf[1].RequestPathstring | null כן
$.oneOf[1].RequestStatus = "Failed" כן
$.oneOf[1].ResponseCodeinteger כן
$.oneOf[1].ResponseMessageAPIResponseMessage כן
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null כן
$.oneOf[1].ResponseMessage.oneOf[1]array כן
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage לא
$.oneOf[1].ResponseMessage.oneOf[2]object כן
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage לא
$.oneOf[1].RequestImpersonatedByUserAliasstring לא
דוגמת תגובה
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/external_messaging/get_delivery_health",
    "RequestUserAlias": "example-user",
    "Payload": {
        "window": "7 days",
        "messageCounts": {
            "Queued": 0,
            "Sending": 0,
            "Sent": 0,
            "Deferred": 0,
            "Suppressed": 0,
            "Failed": 0
        },
        "identityCounts": [],
        "suppressionCount": 0
    }
}
תיעוד נקודת קצה קריא למכונה
GET

/v1/external_messaging/get_events

#
Returns the event timeline for a message.

פרמטרים

שםסוגחובהברירת מחדלתיאור
messageID string לא "" Message numeric ID or UUID.
דוגמת בקשה (cURL)
curl --get \
  'https://he.appointmenttrader.com/v1/external_messaging/get_events' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'messageID={{messageID}}'

ערך מוחזר

JSON
See the shared response schema and synthetic example.
שדות התגובה
שדהסוגחובהתיאור
$external_messaging_get_events_Response כן
$.oneOf[0] כן
$.oneOf[0].allOf[0]object כן
$.oneOf[0].allOf[0].RequestUserAliasstring כן
$.oneOf[0].allOf[0].RequestPathstring | null כן
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" כן
$.oneOf[0].allOf[0].ResponseCodeinteger כן
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage לא
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage לא
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring לא
$.oneOf[0].allOf[1]object כן
$.oneOf[0].allOf[1].Payloadobject כן
$.oneOf[0].allOf[1].Payload.eventsarray כן
$.oneOf[0].allOf[1].Payload.events[]object לא
$.oneOf[0].allOf[1].Payload.events[].IDDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.events[].ID.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.events[].ID.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.events[].CreatedDatestring כן
$.oneOf[0].allOf[1].Payload.events[].ATExternalMessagingMessages_IDDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.events[].ATExternalMessagingMessages_ID.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.events[].ATExternalMessagingMessages_ID.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.events[].Channelstring כן
$.oneOf[0].allOf[1].Payload.events[].EventTypestring כן
$.oneOf[0].allOf[1].Payload.events[].Severitystring כן
$.oneOf[0].allOf[1].Payload.events[].RecipientAddress כן
$.oneOf[0].allOf[1].Payload.events[].RecipientAddress.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.events[].RecipientAddress.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.events[].ProviderMessageID כן
$.oneOf[0].allOf[1].Payload.events[].ProviderMessageID.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.events[].ProviderMessageID.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.events[].ATExternalMessagingChannelConfigs_ID כן
$.oneOf[0].allOf[1].Payload.events[].ATExternalMessagingChannelConfigs_ID.anyOf[0]DatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.events[].ATExternalMessagingChannelConfigs_ID.anyOf[0].oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.events[].ATExternalMessagingChannelConfigs_ID.anyOf[0].oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.events[].ATExternalMessagingChannelConfigs_ID.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[0] = null כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[1] = "" כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[2]object כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[2].IDDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[2].ID.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[2].ID.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[2].CreatedDatestring כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[2].LastUpdateDatestring כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[2].DeletedDate כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[2].DeletedDate.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[2].DeletedDate.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[2].ATUser_ID כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[2].ATUser_ID.anyOf[0]DatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[2].ATUser_ID.anyOf[0].oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[2].ATUser_ID.anyOf[0].oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[2].ATUser_ID.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[2].Channelstring כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[2].Scopestring כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[2].ATExternalMessagingIdentities_ID כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[2].ATExternalMessagingIdentities_ID.anyOf[0]DatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[2].ATExternalMessagingIdentities_ID.anyOf[0].oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[2].ATExternalMessagingIdentities_ID.anyOf[0].oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[2].ATExternalMessagingIdentities_ID.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[2].RecipientAddress כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[2].RecipientAddress.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[2].RecipientAddress.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[2].RecipientHash כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[2].RecipientHash.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[2].RecipientHash.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[2].SuppressionTypestring כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[2].Reason כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[2].Reason.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[2].Reason.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[2].ExpiresDate כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[2].ExpiresDate.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[2].ExpiresDate.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[2].CreatedBy-ATUser_ID כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[2].CreatedBy-ATUser_ID.anyOf[0]DatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[2].CreatedBy-ATUser_ID.anyOf[0].oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[2].CreatedBy-ATUser_ID.anyOf[0].oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[2].CreatedBy-ATUser_ID.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[2].DeletedBy-ATUser_ID כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[2].DeletedBy-ATUser_ID.anyOf[0]DatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[2].DeletedBy-ATUser_ID.anyOf[0].oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[2].DeletedBy-ATUser_ID.anyOf[0].oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[2].DeletedBy-ATUser_ID.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[3]object כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[3].endpointstring כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[4]object כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[4].reasonstring כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[4].delayMinutesinteger כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[5]object כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[5].acceptedboolean כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[5].providerMessageID לא
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[5].providerMessageID.anyOf[0]string לא
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[5].providerMessageID.anyOf[1]null לא
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[5].statusCodeinteger לא
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[5].responseExternalMessageProviderValue לא
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[5].response.oneOf[0]string | number | boolean | null לא
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[5].response.oneOf[1]array לא
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[5].response.oneOf[1][]ExternalMessageProviderValue לא
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[5].response.oneOf[2]object לא
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[5].response.oneOf[2].*ExternalMessageProviderValue לא
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[5].errorstring לא
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[6]object כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[6].ledgerIDDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[6].ledgerID.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[6].ledgerID.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[6].priceAmountinteger כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[6].priceUnitstring ["USD","Traderpoint"] כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[7]object כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[7].*ExternalMessageProviderValue לא
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[7].*.oneOf[0]string | number | boolean | null לא
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[7].*.oneOf[1]array לא
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[7].*.oneOf[1][]ExternalMessageProviderValue לא
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[7].*.oneOf[2]object לא
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[7].*.oneOf[2].*ExternalMessageProviderValue לא
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[8]array כן
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[9]array כןProvider callback arrays are preserved when supplied.
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[9][]ExternalMessageProviderValue לא
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[9][].oneOf[0]string | number | boolean | null לא
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[9][].oneOf[1]array לא
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[9][].oneOf[1][]ExternalMessageProviderValue לא
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[9][].oneOf[2]object לא
$.oneOf[0].allOf[1].Payload.events[].EventPayload.anyOf[9][].oneOf[2].*ExternalMessageProviderValue לא
$.oneOf[1]object כן
$.oneOf[1].RequestUserAliasstring כן
$.oneOf[1].RequestPathstring | null כן
$.oneOf[1].RequestStatus = "Failed" כן
$.oneOf[1].ResponseCodeinteger כן
$.oneOf[1].ResponseMessageAPIResponseMessage כן
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null כן
$.oneOf[1].ResponseMessage.oneOf[1]array כן
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage לא
$.oneOf[1].ResponseMessage.oneOf[2]object כן
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage לא
$.oneOf[1].RequestImpersonatedByUserAliasstring לא
דוגמת תגובה
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/external_messaging/get_events",
    "RequestUserAlias": "example-user",
    "Payload": {
        "events": []
    }
}
תיעוד נקודת קצה קריא למכונה
GET

/v1/external_messaging/get_identities

#
Returns sender identities owned by the API user.

פרמטרים

שםסוגחובהברירת מחדלתיאור
channel string לא "email" Channel to list. Phase one supports email.
דוגמת בקשה (cURL)
curl --get \
  'https://he.appointmenttrader.com/v1/external_messaging/get_identities' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'channel={{channel}}'

ערך מוחזר

JSON
See the shared response schema and synthetic example.
שדות התגובה
שדהסוגחובהתיאור
$external_messaging_get_identities_Response כן
$.oneOf[0] כן
$.oneOf[0].allOf[0]object כן
$.oneOf[0].allOf[0].RequestUserAliasstring כן
$.oneOf[0].allOf[0].RequestPathstring | null כן
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" כן
$.oneOf[0].allOf[0].ResponseCodeinteger כן
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage לא
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage לא
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring לא
$.oneOf[0].allOf[1]object כן
$.oneOf[0].allOf[1].Payloadobject כן
$.oneOf[0].allOf[1].Payload.identitiesarray כן
$.oneOf[0].allOf[1].Payload.identities[]object לא
$.oneOf[0].allOf[1].Payload.identities[].IDDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.identities[].ID.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.identities[].ID.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.identities[].IdentityUUIDstring כן
$.oneOf[0].allOf[1].Payload.identities[].CreatedDatestring כן
$.oneOf[0].allOf[1].Payload.identities[].LastUpdateDatestring כן
$.oneOf[0].allOf[1].Payload.identities[].ATUser_IDDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.identities[].ATUser_ID.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.identities[].ATUser_ID.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.identities[].Channel = "email" כן
$.oneOf[0].allOf[1].Payload.identities[].Streamstring ["auth","transactional","community","bulk","sandbox"] כן
$.oneOf[0].allOf[1].Payload.identities[].Statusstring ["PendingDNS","Verified","Suspended"] כן
$.oneOf[0].allOf[1].Payload.identities[].Namestring כן
$.oneOf[0].allOf[1].Payload.identities[].FromName כן
$.oneOf[0].allOf[1].Payload.identities[].FromName.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.identities[].FromName.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.identities[].FromAddress כן
$.oneOf[0].allOf[1].Payload.identities[].FromAddress.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.identities[].FromAddress.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.identities[].DomainName כן
$.oneOf[0].allOf[1].Payload.identities[].DomainName.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.identities[].DomainName.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.identities[].ReturnPathDomain כן
$.oneOf[0].allOf[1].Payload.identities[].ReturnPathDomain.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.identities[].ReturnPathDomain.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.identities[].DKIMSelector כן
$.oneOf[0].allOf[1].Payload.identities[].DKIMSelector.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.identities[].DKIMSelector.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.identities[].DNSLastCheckTime כן
$.oneOf[0].allOf[1].Payload.identities[].DNSLastCheckTime.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.identities[].DNSLastCheckTime.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.identities[].LastVerifiedTime כן
$.oneOf[0].allOf[1].Payload.identities[].LastVerifiedTime.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.identities[].LastVerifiedTime.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.identities[].ATUser_Alias כן
$.oneOf[0].allOf[1].Payload.identities[].ATUser_Alias.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.identities[].ATUser_Alias.anyOf[1]null כן
$.oneOf[1]object כן
$.oneOf[1].RequestUserAliasstring כן
$.oneOf[1].RequestPathstring | null כן
$.oneOf[1].RequestStatus = "Failed" כן
$.oneOf[1].ResponseCodeinteger כן
$.oneOf[1].ResponseMessageAPIResponseMessage כן
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null כן
$.oneOf[1].ResponseMessage.oneOf[1]array כן
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage לא
$.oneOf[1].ResponseMessage.oneOf[2]object כן
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage לא
$.oneOf[1].RequestImpersonatedByUserAliasstring לא
דוגמת תגובה
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/external_messaging/get_identities",
    "RequestUserAlias": "example-user",
    "Payload": {
        "identities": []
    }
}
תיעוד נקודת קצה קריא למכונה
GET

/v1/external_messaging/get_identity_dns_status

#
Returns expected and last observed DNS state for an identity.

פרמטרים

שםסוגחובהברירת מחדלתיאור
identityID int לא 0 Sender identity ID.
דוגמת בקשה (cURL)
curl --get \
  'https://he.appointmenttrader.com/v1/external_messaging/get_identity_dns_status' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'identityID={{identityID}}'

ערך מוחזר

JSON
See the shared response schema and synthetic example.
שדות התגובה
שדהסוגחובהתיאור
$external_messaging_get_identity_dns_status_Response כן
$.oneOf[0] כן
$.oneOf[0].allOf[0]object כן
$.oneOf[0].allOf[0].RequestUserAliasstring כן
$.oneOf[0].allOf[0].RequestPathstring | null כן
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" כן
$.oneOf[0].allOf[0].ResponseCodeinteger כן
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage לא
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage לא
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring לא
$.oneOf[0].allOf[1]object כן
$.oneOf[0].allOf[1].Payloadobject כן
$.oneOf[0].allOf[1].Payload.identityobject כן
$.oneOf[0].allOf[1].Payload.identity.IDDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.identity.ID.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.identity.ID.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.identity.CreatedDatestring כן
$.oneOf[0].allOf[1].Payload.identity.LastUpdateDatestring כן
$.oneOf[0].allOf[1].Payload.identity.DeletedDate כן
$.oneOf[0].allOf[1].Payload.identity.DeletedDate.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.identity.DeletedDate.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.identity.IdentityUUIDstring כן
$.oneOf[0].allOf[1].Payload.identity.ATUser_IDDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.identity.ATUser_ID.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.identity.ATUser_ID.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.identity.CreatedBy-ATUser_ID כן
$.oneOf[0].allOf[1].Payload.identity.CreatedBy-ATUser_ID.anyOf[0]DatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.identity.CreatedBy-ATUser_ID.anyOf[0].oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.identity.CreatedBy-ATUser_ID.anyOf[0].oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.identity.CreatedBy-ATUser_ID.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.identity.Channel = "email" כן
$.oneOf[0].allOf[1].Payload.identity.Streamstring ["auth","transactional","community","bulk","sandbox"] כן
$.oneOf[0].allOf[1].Payload.identity.Statusstring ["PendingDNS","Verified","Suspended"] כן
$.oneOf[0].allOf[1].Payload.identity.Namestring כן
$.oneOf[0].allOf[1].Payload.identity.FromName כן
$.oneOf[0].allOf[1].Payload.identity.FromName.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.identity.FromName.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.identity.FromAddress כן
$.oneOf[0].allOf[1].Payload.identity.FromAddress.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.identity.FromAddress.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.identity.DomainName כן
$.oneOf[0].allOf[1].Payload.identity.DomainName.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.identity.DomainName.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.identity.ReturnPathDomain כן
$.oneOf[0].allOf[1].Payload.identity.ReturnPathDomain.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.identity.ReturnPathDomain.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.identity.DKIMSelector כן
$.oneOf[0].allOf[1].Payload.identity.DKIMSelector.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.identity.DKIMSelector.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.identity.DKIMPublicKey כן
$.oneOf[0].allOf[1].Payload.identity.DKIMPublicKey.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.identity.DKIMPublicKey.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.identity.DKIMPrivateKeyEnvironmentKey כן
$.oneOf[0].allOf[1].Payload.identity.DKIMPrivateKeyEnvironmentKey.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.identity.DKIMPrivateKeyEnvironmentKey.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.identity.VerificationToken כן
$.oneOf[0].allOf[1].Payload.identity.VerificationToken.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.identity.VerificationToken.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.identity.DNSExpectedPayload כן
$.oneOf[0].allOf[1].Payload.identity.DNSExpectedPayload.anyOf[0]array כן
$.oneOf[0].allOf[1].Payload.identity.DNSExpectedPayload.anyOf[0][]object לא
$.oneOf[0].allOf[1].Payload.identity.DNSExpectedPayload.anyOf[0][].keystring ["ownership","dkim","dmarc","return_path","mta_sts","tls_reporting"] כן
$.oneOf[0].allOf[1].Payload.identity.DNSExpectedPayload.anyOf[0][].labelstring כן
$.oneOf[0].allOf[1].Payload.identity.DNSExpectedPayload.anyOf[0][].typestring ["TXT","MX"] כן
$.oneOf[0].allOf[1].Payload.identity.DNSExpectedPayload.anyOf[0][].hoststring כן
$.oneOf[0].allOf[1].Payload.identity.DNSExpectedPayload.anyOf[0][].valuestring כן
$.oneOf[0].allOf[1].Payload.identity.DNSExpectedPayload.anyOf[0][].requiredboolean כן
$.oneOf[0].allOf[1].Payload.identity.DNSExpectedPayload.anyOf[0][].statusstring ["pending","verified","missing","advisory"] כן
$.oneOf[0].allOf[1].Payload.identity.DNSExpectedPayload.anyOf[0][].observedValuestring לא
$.oneOf[0].allOf[1].Payload.identity.DNSExpectedPayload.anyOf[1] = "" כן
$.oneOf[0].allOf[1].Payload.identity.DNSExpectedPayload.anyOf[2] = null כן
$.oneOf[0].allOf[1].Payload.identity.DNSLastCheckPayload כן
$.oneOf[0].allOf[1].Payload.identity.DNSLastCheckPayload.anyOf[0]array כן
$.oneOf[0].allOf[1].Payload.identity.DNSLastCheckPayload.anyOf[0][]object לא
$.oneOf[0].allOf[1].Payload.identity.DNSLastCheckPayload.anyOf[0][].keystring ["ownership","dkim","dmarc","return_path","mta_sts","tls_reporting"] כן
$.oneOf[0].allOf[1].Payload.identity.DNSLastCheckPayload.anyOf[0][].labelstring כן
$.oneOf[0].allOf[1].Payload.identity.DNSLastCheckPayload.anyOf[0][].typestring ["TXT","MX"] כן
$.oneOf[0].allOf[1].Payload.identity.DNSLastCheckPayload.anyOf[0][].hoststring כן
$.oneOf[0].allOf[1].Payload.identity.DNSLastCheckPayload.anyOf[0][].valuestring כן
$.oneOf[0].allOf[1].Payload.identity.DNSLastCheckPayload.anyOf[0][].requiredboolean כן
$.oneOf[0].allOf[1].Payload.identity.DNSLastCheckPayload.anyOf[0][].statusstring ["pending","verified","missing","advisory"] כן
$.oneOf[0].allOf[1].Payload.identity.DNSLastCheckPayload.anyOf[0][].observedValuestring לא
$.oneOf[0].allOf[1].Payload.identity.DNSLastCheckPayload.anyOf[1] = "" כן
$.oneOf[0].allOf[1].Payload.identity.DNSLastCheckPayload.anyOf[2] = null כן
$.oneOf[0].allOf[1].Payload.identity.DNSLastCheckTime כן
$.oneOf[0].allOf[1].Payload.identity.DNSLastCheckTime.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.identity.DNSLastCheckTime.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.identity.LastVerifiedTime כן
$.oneOf[0].allOf[1].Payload.identity.LastVerifiedTime.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.identity.LastVerifiedTime.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.identity.LastVerifiedBy-ATUser_ID כן
$.oneOf[0].allOf[1].Payload.identity.LastVerifiedBy-ATUser_ID.anyOf[0]DatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.identity.LastVerifiedBy-ATUser_ID.anyOf[0].oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.identity.LastVerifiedBy-ATUser_ID.anyOf[0].oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.identity.LastVerifiedBy-ATUser_ID.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.identity.ATUser_Alias כן
$.oneOf[0].allOf[1].Payload.identity.ATUser_Alias.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.identity.ATUser_Alias.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.dnsRecordsarray כן
$.oneOf[0].allOf[1].Payload.dnsRecords[]object לא
$.oneOf[0].allOf[1].Payload.dnsRecords[].keystring ["ownership","dkim","dmarc","return_path","mta_sts","tls_reporting"] כן
$.oneOf[0].allOf[1].Payload.dnsRecords[].labelstring כן
$.oneOf[0].allOf[1].Payload.dnsRecords[].typestring ["TXT","MX"] כן
$.oneOf[0].allOf[1].Payload.dnsRecords[].hoststring כן
$.oneOf[0].allOf[1].Payload.dnsRecords[].valuestring כן
$.oneOf[0].allOf[1].Payload.dnsRecords[].requiredboolean כן
$.oneOf[0].allOf[1].Payload.dnsRecords[].statusstring ["pending","verified","missing","advisory"] כן
$.oneOf[0].allOf[1].Payload.dnsRecords[].observedValuestring לא
$.oneOf[0].allOf[1].Payload.lastCheck כן
$.oneOf[0].allOf[1].Payload.lastCheck.anyOf[0]array כן
$.oneOf[0].allOf[1].Payload.lastCheck.anyOf[0][]object לא
$.oneOf[0].allOf[1].Payload.lastCheck.anyOf[0][].keystring ["ownership","dkim","dmarc","return_path","mta_sts","tls_reporting"] כן
$.oneOf[0].allOf[1].Payload.lastCheck.anyOf[0][].labelstring כן
$.oneOf[0].allOf[1].Payload.lastCheck.anyOf[0][].typestring ["TXT","MX"] כן
$.oneOf[0].allOf[1].Payload.lastCheck.anyOf[0][].hoststring כן
$.oneOf[0].allOf[1].Payload.lastCheck.anyOf[0][].valuestring כן
$.oneOf[0].allOf[1].Payload.lastCheck.anyOf[0][].requiredboolean כן
$.oneOf[0].allOf[1].Payload.lastCheck.anyOf[0][].statusstring ["pending","verified","missing","advisory"] כן
$.oneOf[0].allOf[1].Payload.lastCheck.anyOf[0][].observedValuestring לא
$.oneOf[0].allOf[1].Payload.lastCheck.anyOf[1] = "" כן
$.oneOf[0].allOf[1].Payload.lastCheck.anyOf[2] = null כן
$.oneOf[1]object כן
$.oneOf[1].RequestUserAliasstring כן
$.oneOf[1].RequestPathstring | null כן
$.oneOf[1].RequestStatus = "Failed" כן
$.oneOf[1].ResponseCodeinteger כן
$.oneOf[1].ResponseMessageAPIResponseMessage כן
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null כן
$.oneOf[1].ResponseMessage.oneOf[1]array כן
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage לא
$.oneOf[1].ResponseMessage.oneOf[2]object כן
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage לא
$.oneOf[1].RequestImpersonatedByUserAliasstring לא
דוגמת תגובה
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/external_messaging/get_identity_dns_status",
    "RequestUserAlias": "example-user",
    "Payload": {
        "identity": {
            "ID": 0,
            "CreatedDate": "synthetic-example",
            "LastUpdateDate": "synthetic-example",
            "DeletedDate": "synthetic-example",
            "IdentityUUID": "synthetic-example",
            "ATUser_ID": 0,
            "CreatedBy-ATUser_ID": 0,
            "Channel": "email",
            "Stream": "auth",
            "Status": "PendingDNS",
            "Name": "synthetic-example",
            "FromName": "synthetic-example",
            "FromAddress": "synthetic-example",
            "DomainName": "synthetic-example",
            "ReturnPathDomain": "synthetic-example",
            "DKIMSelector": "synthetic-example",
            "DKIMPublicKey": "synthetic-example",
            "DKIMPrivateKeyEnvironmentKey": "synthetic-example",
            "VerificationToken": "synthetic-example",
            "DNSExpectedPayload": [],
            "DNSLastCheckPayload": [],
            "DNSLastCheckTime": "synthetic-example",
            "LastVerifiedTime": "synthetic-example",
            "LastVerifiedBy-ATUser_ID": 0,
            "ATUser_Alias": "synthetic-example"
        },
        "dnsRecords": [],
        "lastCheck": []
    }
}
תיעוד נקודת קצה קריא למכונה
GET

/v1/external_messaging/get_message

#
Returns a queued/sent message by numeric ID or UUID.

פרמטרים

שםסוגחובהברירת מחדלתיאור
messageID string לא "" Message numeric ID or UUID.
דוגמת בקשה (cURL)
curl --get \
  'https://he.appointmenttrader.com/v1/external_messaging/get_message' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'messageID={{messageID}}'

ערך מוחזר

JSON
See the shared response schema and synthetic example.
שדות התגובה
שדהסוגחובהתיאור
$external_messaging_get_message_Response כן
$.oneOf[0] כן
$.oneOf[0].allOf[0]object כן
$.oneOf[0].allOf[0].RequestUserAliasstring כן
$.oneOf[0].allOf[0].RequestPathstring | null כן
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" כן
$.oneOf[0].allOf[0].ResponseCodeinteger כן
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage לא
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage לא
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring לא
$.oneOf[0].allOf[1]object כן
$.oneOf[0].allOf[1].Payloadobject כן
$.oneOf[0].allOf[1].Payload.messageobject כן
$.oneOf[0].allOf[1].Payload.message.IDDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.message.ID.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.message.ID.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.message.CreatedDatestring כן
$.oneOf[0].allOf[1].Payload.message.LastUpdateDatestring כן
$.oneOf[0].allOf[1].Payload.message.DeletedDate כן
$.oneOf[0].allOf[1].Payload.message.DeletedDate.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.message.DeletedDate.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.message.MessageUUIDstring כן
$.oneOf[0].allOf[1].Payload.message.ATUser_IDDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.message.ATUser_ID.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.message.ATUser_ID.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.message.ImpersonatedBy-ATUser_ID כן
$.oneOf[0].allOf[1].Payload.message.ImpersonatedBy-ATUser_ID.anyOf[0]DatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.message.ImpersonatedBy-ATUser_ID.anyOf[0].oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.message.ImpersonatedBy-ATUser_ID.anyOf[0].oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.message.ImpersonatedBy-ATUser_ID.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.message.Channel = "email" כן
$.oneOf[0].allOf[1].Payload.message.Streamstring ["auth","transactional","community","bulk","sandbox"] כן
$.oneOf[0].allOf[1].Payload.message.Modestring ["sandbox","production"] כן
$.oneOf[0].allOf[1].Payload.message.Statusstring ["Queued","Sending","Sent","Deferred","Suppressed","Failed"] כן
$.oneOf[0].allOf[1].Payload.message.ATExternalMessagingIdentities_ID כן
$.oneOf[0].allOf[1].Payload.message.ATExternalMessagingIdentities_ID.anyOf[0]DatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.message.ATExternalMessagingIdentities_ID.anyOf[0].oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.message.ATExternalMessagingIdentities_ID.anyOf[0].oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.message.ATExternalMessagingIdentities_ID.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.message.Funding-ATAccounts_ID כן
$.oneOf[0].allOf[1].Payload.message.Funding-ATAccounts_ID.anyOf[0]DatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.message.Funding-ATAccounts_ID.anyOf[0].oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.message.Funding-ATAccounts_ID.anyOf[0].oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.message.Funding-ATAccounts_ID.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.message.Settlement-ATAccountsLedger_ID כן
$.oneOf[0].allOf[1].Payload.message.Settlement-ATAccountsLedger_ID.anyOf[0]DatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.message.Settlement-ATAccountsLedger_ID.anyOf[0].oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.message.Settlement-ATAccountsLedger_ID.anyOf[0].oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.message.Settlement-ATAccountsLedger_ID.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.message.ATAPIAccessLog_ID כן
$.oneOf[0].allOf[1].Payload.message.ATAPIAccessLog_ID.anyOf[0]DatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.message.ATAPIAccessLog_ID.anyOf[0].oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.message.ATAPIAccessLog_ID.anyOf[0].oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.message.ATAPIAccessLog_ID.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.message.Subject כן
$.oneOf[0].allOf[1].Payload.message.Subject.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.message.Subject.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.message.RecipientsPayload כן
$.oneOf[0].allOf[1].Payload.message.RecipientsPayload.anyOf[0]object כן
$.oneOf[0].allOf[1].Payload.message.RecipientsPayload.anyOf[0].toarray כן
$.oneOf[0].allOf[1].Payload.message.RecipientsPayload.anyOf[0].to[]string לא
$.oneOf[0].allOf[1].Payload.message.RecipientsPayload.anyOf[1] = "" כן
$.oneOf[0].allOf[1].Payload.message.RecipientsPayload.anyOf[2] = null כן
$.oneOf[0].allOf[1].Payload.message.ContentPayload כן
$.oneOf[0].allOf[1].Payload.message.ContentPayload.anyOf[0]object כן
$.oneOf[0].allOf[1].Payload.message.ContentPayload.anyOf[0].htmlBodystring כן
$.oneOf[0].allOf[1].Payload.message.ContentPayload.anyOf[0].textBodystring כן
$.oneOf[0].allOf[1].Payload.message.ContentPayload.anyOf[1] = "" כן
$.oneOf[0].allOf[1].Payload.message.ContentPayload.anyOf[2] = null כן
$.oneOf[0].allOf[1].Payload.message.HeadersPayload כן
$.oneOf[0].allOf[1].Payload.message.HeadersPayload.anyOf[0]object כן
$.oneOf[0].allOf[1].Payload.message.HeadersPayload.anyOf[0].Fromstring כן
$.oneOf[0].allOf[1].Payload.message.HeadersPayload.anyOf[0].X-AT-External-Messaging-Streamstring ["auth","transactional","community","bulk","sandbox"] כן
$.oneOf[0].allOf[1].Payload.message.HeadersPayload.anyOf[0].List-Unsubscribestring לא
$.oneOf[0].allOf[1].Payload.message.HeadersPayload.anyOf[0].List-Unsubscribe-Post = "List-Unsubscribe=One-Click" לא
$.oneOf[0].allOf[1].Payload.message.HeadersPayload.anyOf[1] = "" כן
$.oneOf[0].allOf[1].Payload.message.HeadersPayload.anyOf[2] = null כן
$.oneOf[0].allOf[1].Payload.message.PriceAmountDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.message.PriceAmount.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.message.PriceAmount.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.message.PriceUnit כן
$.oneOf[0].allOf[1].Payload.message.PriceUnit.anyOf[0]string ["USD","Traderpoint"] כן
$.oneOf[0].allOf[1].Payload.message.PriceUnit.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.message.RecipientCountDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.message.RecipientCount.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.message.RecipientCount.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.message.AttemptCountDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.message.AttemptCount.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.message.AttemptCount.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.message.NextAttemptDate כן
$.oneOf[0].allOf[1].Payload.message.NextAttemptDate.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.message.NextAttemptDate.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.message.QueuedDate כן
$.oneOf[0].allOf[1].Payload.message.QueuedDate.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.message.QueuedDate.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.message.SentDate כן
$.oneOf[0].allOf[1].Payload.message.SentDate.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.message.SentDate.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.message.LastEventDate כן
$.oneOf[0].allOf[1].Payload.message.LastEventDate.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.message.LastEventDate.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.message.ProviderMessageID כן
$.oneOf[0].allOf[1].Payload.message.ProviderMessageID.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.message.ProviderMessageID.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.message.FailureReason כן
$.oneOf[0].allOf[1].Payload.message.FailureReason.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.message.FailureReason.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.message.FromAddress כן
$.oneOf[0].allOf[1].Payload.message.FromAddress.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.message.FromAddress.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.message.DomainName כן
$.oneOf[0].allOf[1].Payload.message.DomainName.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.message.DomainName.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.message.ATUser_Alias כן
$.oneOf[0].allOf[1].Payload.message.ATUser_Alias.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.message.ATUser_Alias.anyOf[1]null כן
$.oneOf[1]object כן
$.oneOf[1].RequestUserAliasstring כן
$.oneOf[1].RequestPathstring | null כן
$.oneOf[1].RequestStatus = "Failed" כן
$.oneOf[1].ResponseCodeinteger כן
$.oneOf[1].ResponseMessageAPIResponseMessage כן
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null כן
$.oneOf[1].ResponseMessage.oneOf[1]array כן
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage לא
$.oneOf[1].ResponseMessage.oneOf[2]object כן
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage לא
$.oneOf[1].RequestImpersonatedByUserAliasstring לא
דוגמת תגובה
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/external_messaging/get_message",
    "RequestUserAlias": "example-user",
    "Payload": {
        "message": {
            "ID": 0,
            "CreatedDate": "synthetic-example",
            "LastUpdateDate": "synthetic-example",
            "DeletedDate": "synthetic-example",
            "MessageUUID": "synthetic-example",
            "ATUser_ID": 0,
            "ImpersonatedBy-ATUser_ID": 0,
            "Channel": "email",
            "Stream": "auth",
            "Mode": "sandbox",
            "Status": "Queued",
            "ATExternalMessagingIdentities_ID": 0,
            "Funding-ATAccounts_ID": 0,
            "Settlement-ATAccountsLedger_ID": 0,
            "ATAPIAccessLog_ID": 0,
            "Subject": "synthetic-example",
            "RecipientsPayload": {
                "to": []
            },
            "ContentPayload": {
                "htmlBody": "synthetic-example",
                "textBody": "synthetic-example"
            },
            "HeadersPayload": {
                "From": "synthetic-example",
                "X-AT-External-Messaging-Stream": "auth"
            },
            "PriceAmount": 0,
            "PriceUnit": "USD",
            "RecipientCount": 0,
            "AttemptCount": 0,
            "NextAttemptDate": "synthetic-example",
            "QueuedDate": "synthetic-example",
            "SentDate": "synthetic-example",
            "LastEventDate": "synthetic-example",
            "ProviderMessageID": "synthetic-example",
            "FailureReason": "synthetic-example",
            "FromAddress": "synthetic-example",
            "DomainName": "synthetic-example",
            "ATUser_Alias": "synthetic-example"
        }
    }
}
תיעוד נקודת קצה קריא למכונה
GET

/v1/external_messaging/get_messages

#
Returns recent messages for the API user.

פרמטרים

שםסוגחובהברירת מחדלתיאור
channel string לא "email" Channel filter.
status string לא "" Optional status filter.
limit int לא 50 Maximum rows to return.
דוגמת בקשה (cURL)
curl --get \
  'https://he.appointmenttrader.com/v1/external_messaging/get_messages' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'channel={{channel}}' \
  --data-urlencode 'status={{status}}' \
  --data-urlencode 'limit={{limit}}'

ערך מוחזר

JSON
See the shared response schema and synthetic example.
שדות התגובה
שדהסוגחובהתיאור
$external_messaging_get_messages_Response כן
$.oneOf[0] כן
$.oneOf[0].allOf[0]object כן
$.oneOf[0].allOf[0].RequestUserAliasstring כן
$.oneOf[0].allOf[0].RequestPathstring | null כן
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" כן
$.oneOf[0].allOf[0].ResponseCodeinteger כן
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage לא
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage לא
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring לא
$.oneOf[0].allOf[1]object כן
$.oneOf[0].allOf[1].Payloadobject כן
$.oneOf[0].allOf[1].Payload.messagesarray כן
$.oneOf[0].allOf[1].Payload.messages[]object לא
$.oneOf[0].allOf[1].Payload.messages[].IDDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.messages[].ID.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.messages[].ID.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.messages[].MessageUUIDstring כן
$.oneOf[0].allOf[1].Payload.messages[].CreatedDatestring כן
$.oneOf[0].allOf[1].Payload.messages[].LastUpdateDatestring כן
$.oneOf[0].allOf[1].Payload.messages[].Channel = "email" כן
$.oneOf[0].allOf[1].Payload.messages[].Streamstring ["auth","transactional","community","bulk","sandbox"] כן
$.oneOf[0].allOf[1].Payload.messages[].Modestring ["sandbox","production"] כן
$.oneOf[0].allOf[1].Payload.messages[].Statusstring ["Queued","Sending","Sent","Deferred","Suppressed","Failed"] כן
$.oneOf[0].allOf[1].Payload.messages[].Subject כן
$.oneOf[0].allOf[1].Payload.messages[].Subject.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.messages[].Subject.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.messages[].RecipientCountDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.messages[].RecipientCount.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.messages[].RecipientCount.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.messages[].PriceAmountDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.messages[].PriceAmount.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.messages[].PriceAmount.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.messages[].PriceUnit כן
$.oneOf[0].allOf[1].Payload.messages[].PriceUnit.anyOf[0]string ["USD","Traderpoint"] כן
$.oneOf[0].allOf[1].Payload.messages[].PriceUnit.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.messages[].AttemptCountDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.messages[].AttemptCount.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.messages[].AttemptCount.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.messages[].QueuedDate כן
$.oneOf[0].allOf[1].Payload.messages[].QueuedDate.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.messages[].QueuedDate.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.messages[].SentDate כן
$.oneOf[0].allOf[1].Payload.messages[].SentDate.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.messages[].SentDate.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.messages[].LastEventDate כן
$.oneOf[0].allOf[1].Payload.messages[].LastEventDate.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.messages[].LastEventDate.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.messages[].ProviderMessageID כן
$.oneOf[0].allOf[1].Payload.messages[].ProviderMessageID.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.messages[].ProviderMessageID.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.messages[].FailureReason כן
$.oneOf[0].allOf[1].Payload.messages[].FailureReason.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.messages[].FailureReason.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.messages[].FromAddress כן
$.oneOf[0].allOf[1].Payload.messages[].FromAddress.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.messages[].FromAddress.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.messages[].DomainName כן
$.oneOf[0].allOf[1].Payload.messages[].DomainName.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.messages[].DomainName.anyOf[1]null כן
$.oneOf[1]object כן
$.oneOf[1].RequestUserAliasstring כן
$.oneOf[1].RequestPathstring | null כן
$.oneOf[1].RequestStatus = "Failed" כן
$.oneOf[1].ResponseCodeinteger כן
$.oneOf[1].ResponseMessageAPIResponseMessage כן
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null כן
$.oneOf[1].ResponseMessage.oneOf[1]array כן
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage לא
$.oneOf[1].ResponseMessage.oneOf[2]object כן
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage לא
$.oneOf[1].RequestImpersonatedByUserAliasstring לא
דוגמת תגובה
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/external_messaging/get_messages",
    "RequestUserAlias": "example-user",
    "Payload": {
        "messages": []
    }
}
תיעוד נקודת קצה קריא למכונה
GET

/v1/external_messaging/get_suppressions

#
Returns active suppressions for the API user.

פרמטרים

שםסוגחובהברירת מחדלתיאור
channel string לא "email" Channel filter.
limit int לא 50 Maximum rows to return.
דוגמת בקשה (cURL)
curl --get \
  'https://he.appointmenttrader.com/v1/external_messaging/get_suppressions' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'channel={{channel}}' \
  --data-urlencode 'limit={{limit}}'

ערך מוחזר

JSON
See the shared response schema and synthetic example.
שדות התגובה
שדהסוגחובהתיאור
$external_messaging_get_suppressions_Response כן
$.oneOf[0] כן
$.oneOf[0].allOf[0]object כן
$.oneOf[0].allOf[0].RequestUserAliasstring כן
$.oneOf[0].allOf[0].RequestPathstring | null כן
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" כן
$.oneOf[0].allOf[0].ResponseCodeinteger כן
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage לא
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage לא
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring לא
$.oneOf[0].allOf[1]object כן
$.oneOf[0].allOf[1].Payloadobject כן
$.oneOf[0].allOf[1].Payload.suppressionsarray כן
$.oneOf[0].allOf[1].Payload.suppressions[]object לא
$.oneOf[0].allOf[1].Payload.suppressions[].IDDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.suppressions[].ID.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.suppressions[].ID.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.suppressions[].CreatedDatestring כן
$.oneOf[0].allOf[1].Payload.suppressions[].LastUpdateDatestring כן
$.oneOf[0].allOf[1].Payload.suppressions[].DeletedDate כן
$.oneOf[0].allOf[1].Payload.suppressions[].DeletedDate.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.suppressions[].DeletedDate.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.suppressions[].ATUser_ID כן
$.oneOf[0].allOf[1].Payload.suppressions[].ATUser_ID.anyOf[0]DatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.suppressions[].ATUser_ID.anyOf[0].oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.suppressions[].ATUser_ID.anyOf[0].oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.suppressions[].ATUser_ID.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.suppressions[].Channelstring כן
$.oneOf[0].allOf[1].Payload.suppressions[].Scopestring כן
$.oneOf[0].allOf[1].Payload.suppressions[].ATExternalMessagingIdentities_ID כן
$.oneOf[0].allOf[1].Payload.suppressions[].ATExternalMessagingIdentities_ID.anyOf[0]DatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.suppressions[].ATExternalMessagingIdentities_ID.anyOf[0].oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.suppressions[].ATExternalMessagingIdentities_ID.anyOf[0].oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.suppressions[].ATExternalMessagingIdentities_ID.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.suppressions[].RecipientAddress כן
$.oneOf[0].allOf[1].Payload.suppressions[].RecipientAddress.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.suppressions[].RecipientAddress.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.suppressions[].RecipientHash כן
$.oneOf[0].allOf[1].Payload.suppressions[].RecipientHash.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.suppressions[].RecipientHash.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.suppressions[].SuppressionTypestring כן
$.oneOf[0].allOf[1].Payload.suppressions[].Reason כן
$.oneOf[0].allOf[1].Payload.suppressions[].Reason.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.suppressions[].Reason.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.suppressions[].ExpiresDate כן
$.oneOf[0].allOf[1].Payload.suppressions[].ExpiresDate.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.suppressions[].ExpiresDate.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.suppressions[].CreatedBy-ATUser_ID כן
$.oneOf[0].allOf[1].Payload.suppressions[].CreatedBy-ATUser_ID.anyOf[0]DatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.suppressions[].CreatedBy-ATUser_ID.anyOf[0].oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.suppressions[].CreatedBy-ATUser_ID.anyOf[0].oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.suppressions[].CreatedBy-ATUser_ID.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.suppressions[].DeletedBy-ATUser_ID כן
$.oneOf[0].allOf[1].Payload.suppressions[].DeletedBy-ATUser_ID.anyOf[0]DatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.suppressions[].DeletedBy-ATUser_ID.anyOf[0].oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.suppressions[].DeletedBy-ATUser_ID.anyOf[0].oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.suppressions[].DeletedBy-ATUser_ID.anyOf[1]null כן
$.oneOf[1]object כן
$.oneOf[1].RequestUserAliasstring כן
$.oneOf[1].RequestPathstring | null כן
$.oneOf[1].RequestStatus = "Failed" כן
$.oneOf[1].ResponseCodeinteger כן
$.oneOf[1].ResponseMessageAPIResponseMessage כן
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null כן
$.oneOf[1].ResponseMessage.oneOf[1]array כן
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage לא
$.oneOf[1].ResponseMessage.oneOf[2]object כן
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage לא
$.oneOf[1].RequestImpersonatedByUserAliasstring לא
דוגמת תגובה
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/external_messaging/get_suppressions",
    "RequestUserAlias": "example-user",
    "Payload": {
        "suppressions": []
    }
}
תיעוד נקודת קצה קריא למכונה
POST

/v1/external_messaging/set_billing_account

#
Sets the default AT account used to pay for accepted production messages.

פרמטרים

שםסוגחובהברירת מחדלתיאור
fundingAccountID int לא 0 AT account ID owned by the API user.
channel string לא "all" Billing channel. Use all for the default setting.
isWritingRequest bool לא false Must be true to update billing settings.
דוגמת בקשה (cURL)
curl --request POST \
  'https://he.appointmenttrader.com/v1/external_messaging/set_billing_account' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'fundingAccountID={{fundingAccountID}}' \
  --data-urlencode 'channel={{channel}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

ערך מוחזר

JSON
See the shared response schema and synthetic example.
שדות התגובה
שדהסוגחובהתיאור
$external_messaging_set_billing_account_Response כן
$.oneOf[0] כן
$.oneOf[0].allOf[0]object כן
$.oneOf[0].allOf[0].RequestUserAliasstring כן
$.oneOf[0].allOf[0].RequestPathstring | null כן
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" כן
$.oneOf[0].allOf[0].ResponseCodeinteger כן
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage לא
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage לא
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring לא
$.oneOf[0].allOf[1]object כן
$.oneOf[0].allOf[1].Payloadobject כן
$.oneOf[0].allOf[1].Payload.Succeeded = true כן
$.oneOf[0].allOf[1].Payload.BillingSettingsobject כן
$.oneOf[0].allOf[1].Payload.BillingSettings.IDDatabaseInteger לאInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.BillingSettings.ID.oneOf[0]integer לא
$.oneOf[0].allOf[1].Payload.BillingSettings.ID.oneOf[1]string לא
$.oneOf[0].allOf[1].Payload.BillingSettings.CreatedDatestring לא
$.oneOf[0].allOf[1].Payload.BillingSettings.LastUpdateDatestring לא
$.oneOf[0].allOf[1].Payload.BillingSettings.DeletedDate לא
$.oneOf[0].allOf[1].Payload.BillingSettings.DeletedDate.anyOf[0]string לא
$.oneOf[0].allOf[1].Payload.BillingSettings.DeletedDate.anyOf[1]null לא
$.oneOf[0].allOf[1].Payload.BillingSettings.ATUser_IDDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.BillingSettings.ATUser_ID.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.BillingSettings.ATUser_ID.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.BillingSettings.Channelstring כן
$.oneOf[0].allOf[1].Payload.BillingSettings.DefaultFunding-ATAccounts_ID כן
$.oneOf[0].allOf[1].Payload.BillingSettings.DefaultFunding-ATAccounts_ID.anyOf[0]DatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.BillingSettings.DefaultFunding-ATAccounts_ID.anyOf[0].oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.BillingSettings.DefaultFunding-ATAccounts_ID.anyOf[0].oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.BillingSettings.DefaultFunding-ATAccounts_ID.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.BillingSettings.LastSetBy-ATUser_ID לא
$.oneOf[0].allOf[1].Payload.BillingSettings.LastSetBy-ATUser_ID.anyOf[0]DatabaseInteger לאInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.BillingSettings.LastSetBy-ATUser_ID.anyOf[0].oneOf[0]integer לא
$.oneOf[0].allOf[1].Payload.BillingSettings.LastSetBy-ATUser_ID.anyOf[0].oneOf[1]string לא
$.oneOf[0].allOf[1].Payload.BillingSettings.LastSetBy-ATUser_ID.anyOf[1]null לא
$.oneOf[0].allOf[1].Payload.BillingSettings.DefaultFundingAccount כן
$.oneOf[0].allOf[1].Payload.BillingSettings.DefaultFundingAccount.anyOf[0]object כן
$.oneOf[0].allOf[1].Payload.BillingSettings.DefaultFundingAccount.anyOf[0].Currencystring כן
$.oneOf[0].allOf[1].Payload.BillingSettings.DefaultFundingAccount.anyOf[0].CurrencySymbolstring כן
$.oneOf[0].allOf[1].Payload.BillingSettings.DefaultFundingAccount.anyOf[0].CreatedDatestring כן
$.oneOf[0].allOf[1].Payload.BillingSettings.DefaultFundingAccount.anyOf[0].LastUpdateDatestring כן
$.oneOf[0].allOf[1].Payload.BillingSettings.DefaultFundingAccount.anyOf[0].Namestring כן
$.oneOf[0].allOf[1].Payload.BillingSettings.DefaultFundingAccount.anyOf[0].Descriptionstring כן
$.oneOf[0].allOf[1].Payload.BillingSettings.DefaultFundingAccount.anyOf[0].IDDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.BillingSettings.DefaultFundingAccount.anyOf[0].ID.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.BillingSettings.DefaultFundingAccount.anyOf[0].ID.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.BillingSettings.DefaultFundingAccount.anyOf[0].ATUser_IDDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.BillingSettings.DefaultFundingAccount.anyOf[0].ATUser_ID.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.BillingSettings.DefaultFundingAccount.anyOf[0].ATUser_ID.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.BillingSettings.DefaultFundingAccount.anyOf[0].CurrencyCreditLimitDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.BillingSettings.DefaultFundingAccount.anyOf[0].CurrencyCreditLimit.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.BillingSettings.DefaultFundingAccount.anyOf[0].CurrencyCreditLimit.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.BillingSettings.DefaultFundingAccount.anyOf[0].PayoutDefaultBasisPointsDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.BillingSettings.DefaultFundingAccount.anyOf[0].PayoutDefaultBasisPoints.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.BillingSettings.DefaultFundingAccount.anyOf[0].PayoutDefaultBasisPoints.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.BillingSettings.DefaultFundingAccount.anyOf[0].PointsCreditLimitDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.BillingSettings.DefaultFundingAccount.anyOf[0].PointsCreditLimit.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.BillingSettings.DefaultFundingAccount.anyOf[0].PointsCreditLimit.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.BillingSettings.DefaultFundingAccount.anyOf[0].IsATCorporateAccountDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.BillingSettings.DefaultFundingAccount.anyOf[0].IsATCorporateAccount.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.BillingSettings.DefaultFundingAccount.anyOf[0].IsATCorporateAccount.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.BillingSettings.DefaultFundingAccount.anyOf[0].IsDefaultDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.BillingSettings.DefaultFundingAccount.anyOf[0].IsDefault.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.BillingSettings.DefaultFundingAccount.anyOf[0].IsDefault.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.BillingSettings.DefaultFundingAccount.anyOf[0].IsDepositAccountDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.BillingSettings.DefaultFundingAccount.anyOf[0].IsDepositAccount.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.BillingSettings.DefaultFundingAccount.anyOf[0].IsDepositAccount.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.BillingSettings.DefaultFundingAccount.anyOf[0].CurrencyBalanceDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.BillingSettings.DefaultFundingAccount.anyOf[0].CurrencyBalance.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.BillingSettings.DefaultFundingAccount.anyOf[0].CurrencyBalance.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.BillingSettings.DefaultFundingAccount.anyOf[0].PointsBalanceDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.BillingSettings.DefaultFundingAccount.anyOf[0].PointsBalance.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.BillingSettings.DefaultFundingAccount.anyOf[0].PointsBalance.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.BillingSettings.DefaultFundingAccount.anyOf[1] = false כן
$.oneOf[0].allOf[1].Payload.BillingSettings.PriceSettingsobject כן
$.oneOf[0].allOf[1].Payload.BillingSettings.PriceSettings.PricePerMessageinteger כן
$.oneOf[0].allOf[1].Payload.BillingSettings.PriceSettings.PriceUnitstring ["USD","Traderpoint"] כן
$.oneOf[0].allOf[1].Payload.BillingSettings.PriceSettings.RateLimitPerHourinteger כן
$.oneOf[0].allOf[1].Payload.BillingSettings.PriceSettings.RecipientLimitPerMessageinteger כן
$.oneOf[1]object כן
$.oneOf[1].RequestUserAliasstring כן
$.oneOf[1].RequestPathstring | null כן
$.oneOf[1].RequestStatus = "Failed" כן
$.oneOf[1].ResponseCodeinteger כן
$.oneOf[1].ResponseMessageAPIResponseMessage כן
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null כן
$.oneOf[1].ResponseMessage.oneOf[1]array כן
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage לא
$.oneOf[1].ResponseMessage.oneOf[2]object כן
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage לא
$.oneOf[1].RequestImpersonatedByUserAliasstring לא
דוגמת תגובה
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/external_messaging/set_billing_account",
    "RequestUserAlias": "example-user",
    "Payload": {
        "Succeeded": true,
        "BillingSettings": {
            "ATUser_ID": 0,
            "Channel": "synthetic-example",
            "DefaultFunding-ATAccounts_ID": 0,
            "DefaultFundingAccount": {
                "Currency": "synthetic-example",
                "CurrencySymbol": "synthetic-example",
                "CreatedDate": "synthetic-example",
                "LastUpdateDate": "synthetic-example",
                "Name": "synthetic-example",
                "Description": "synthetic-example",
                "ID": 0,
                "ATUser_ID": 0,
                "CurrencyCreditLimit": 0,
                "PayoutDefaultBasisPoints": 0,
                "PointsCreditLimit": 0,
                "IsATCorporateAccount": 0,
                "IsDefault": 0,
                "IsDepositAccount": 0,
                "CurrencyBalance": 0,
                "PointsBalance": 0
            },
            "PriceSettings": {
                "PricePerMessage": 0,
                "PriceUnit": "USD",
                "RateLimitPerHour": 0,
                "RecipientLimitPerMessage": 0
            }
        }
    }
}
תיעוד נקודת קצה קריא למכונה
POST

/v1/external_messaging/set_identity

#
Creates an email sender identity and returns the DNS records needed for verification.

פרמטרים

שםסוגחובהברירת מחדלתיאור
channel string לא "email" Channel to create. Phase one supports email.
fromAddress string לא "" Sender email address.
fromName string לא "" Human readable sender name.
name string לא "" Internal identity label.
stream string לא "transactional" Email stream: auth, transactional, community, or bulk.
isWritingRequest bool לא false Must be true to create the identity.
דוגמת בקשה (cURL)
curl --request POST \
  'https://he.appointmenttrader.com/v1/external_messaging/set_identity' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'channel={{channel}}' \
  --data-urlencode 'fromAddress={{fromAddress}}' \
  --data-urlencode 'fromName={{fromName}}' \
  --data-urlencode 'name={{name}}' \
  --data-urlencode 'stream={{stream}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

ערך מוחזר

JSON
See the shared response schema and synthetic example.
שדות התגובה
שדהסוגחובהתיאור
$external_messaging_set_identity_Response כן
$.oneOf[0] כן
$.oneOf[0].allOf[0]object כן
$.oneOf[0].allOf[0].RequestUserAliasstring כן
$.oneOf[0].allOf[0].RequestPathstring | null כן
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" כן
$.oneOf[0].allOf[0].ResponseCodeinteger כן
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage לא
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage לא
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring לא
$.oneOf[0].allOf[1]object כן
$.oneOf[0].allOf[1].Payloadobject כן
$.oneOf[0].allOf[1].Payload.Succeeded = true כן
$.oneOf[0].allOf[1].Payload.Identity כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0]object כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].IDDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].ID.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].ID.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].CreatedDatestring כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].LastUpdateDatestring כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].DeletedDate כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].DeletedDate.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].DeletedDate.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].IdentityUUIDstring כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].ATUser_IDDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].ATUser_ID.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].ATUser_ID.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].CreatedBy-ATUser_ID כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].CreatedBy-ATUser_ID.anyOf[0]DatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].CreatedBy-ATUser_ID.anyOf[0].oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].CreatedBy-ATUser_ID.anyOf[0].oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].CreatedBy-ATUser_ID.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].Channel = "email" כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].Streamstring ["auth","transactional","community","bulk","sandbox"] כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].Statusstring ["PendingDNS","Verified","Suspended"] כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].Namestring כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].FromName כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].FromName.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].FromName.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].FromAddress כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].FromAddress.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].FromAddress.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].DomainName כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].DomainName.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].DomainName.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].ReturnPathDomain כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].ReturnPathDomain.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].ReturnPathDomain.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].DKIMSelector כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].DKIMSelector.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].DKIMSelector.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].DKIMPublicKey כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].DKIMPublicKey.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].DKIMPublicKey.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].DKIMPrivateKeyEnvironmentKey כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].DKIMPrivateKeyEnvironmentKey.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].DKIMPrivateKeyEnvironmentKey.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].VerificationToken כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].VerificationToken.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].VerificationToken.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].DNSExpectedPayload כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].DNSExpectedPayload.anyOf[0]array כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].DNSExpectedPayload.anyOf[0][]object לא
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].DNSExpectedPayload.anyOf[0][].keystring ["ownership","dkim","dmarc","return_path","mta_sts","tls_reporting"] כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].DNSExpectedPayload.anyOf[0][].labelstring כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].DNSExpectedPayload.anyOf[0][].typestring ["TXT","MX"] כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].DNSExpectedPayload.anyOf[0][].hoststring כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].DNSExpectedPayload.anyOf[0][].valuestring כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].DNSExpectedPayload.anyOf[0][].requiredboolean כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].DNSExpectedPayload.anyOf[0][].statusstring ["pending","verified","missing","advisory"] כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].DNSExpectedPayload.anyOf[0][].observedValuestring לא
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].DNSExpectedPayload.anyOf[1] = "" כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].DNSExpectedPayload.anyOf[2] = null כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].DNSLastCheckPayload כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].DNSLastCheckPayload.anyOf[0]array כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].DNSLastCheckPayload.anyOf[0][]object לא
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].DNSLastCheckPayload.anyOf[0][].keystring ["ownership","dkim","dmarc","return_path","mta_sts","tls_reporting"] כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].DNSLastCheckPayload.anyOf[0][].labelstring כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].DNSLastCheckPayload.anyOf[0][].typestring ["TXT","MX"] כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].DNSLastCheckPayload.anyOf[0][].hoststring כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].DNSLastCheckPayload.anyOf[0][].valuestring כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].DNSLastCheckPayload.anyOf[0][].requiredboolean כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].DNSLastCheckPayload.anyOf[0][].statusstring ["pending","verified","missing","advisory"] כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].DNSLastCheckPayload.anyOf[0][].observedValuestring לא
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].DNSLastCheckPayload.anyOf[1] = "" כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].DNSLastCheckPayload.anyOf[2] = null כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].DNSLastCheckTime כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].DNSLastCheckTime.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].DNSLastCheckTime.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].LastVerifiedTime כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].LastVerifiedTime.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].LastVerifiedTime.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].LastVerifiedBy-ATUser_ID כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].LastVerifiedBy-ATUser_ID.anyOf[0]DatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].LastVerifiedBy-ATUser_ID.anyOf[0].oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].LastVerifiedBy-ATUser_ID.anyOf[0].oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].LastVerifiedBy-ATUser_ID.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].ATUser_Alias כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].ATUser_Alias.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[0].ATUser_Alias.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.Identity.anyOf[1] = false כן
$.oneOf[0].allOf[1].Payload.DNSRecordsarray כן
$.oneOf[0].allOf[1].Payload.DNSRecords[]object לא
$.oneOf[0].allOf[1].Payload.DNSRecords[].keystring ["ownership","dkim","dmarc","return_path","mta_sts","tls_reporting"] כן
$.oneOf[0].allOf[1].Payload.DNSRecords[].labelstring כן
$.oneOf[0].allOf[1].Payload.DNSRecords[].typestring ["TXT","MX"] כן
$.oneOf[0].allOf[1].Payload.DNSRecords[].hoststring כן
$.oneOf[0].allOf[1].Payload.DNSRecords[].valuestring כן
$.oneOf[0].allOf[1].Payload.DNSRecords[].requiredboolean כן
$.oneOf[0].allOf[1].Payload.DNSRecords[].statusstring ["pending","verified","missing","advisory"] כן
$.oneOf[0].allOf[1].Payload.DNSRecords[].observedValuestring לא
$.oneOf[0].allOf[1].Payload.DKIMPrivateKeyEnvironmentKeystring כן
$.oneOf[0].allOf[1].Payload.DKIMPrivateKeyOneTimestring כן
$.oneOf[1]object כן
$.oneOf[1].RequestUserAliasstring כן
$.oneOf[1].RequestPathstring | null כן
$.oneOf[1].RequestStatus = "Failed" כן
$.oneOf[1].ResponseCodeinteger כן
$.oneOf[1].ResponseMessageAPIResponseMessage כן
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null כן
$.oneOf[1].ResponseMessage.oneOf[1]array כן
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage לא
$.oneOf[1].ResponseMessage.oneOf[2]object כן
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage לא
$.oneOf[1].RequestImpersonatedByUserAliasstring לא
דוגמת תגובה
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/external_messaging/set_identity",
    "RequestUserAlias": "example-user",
    "Payload": {
        "Succeeded": true,
        "Identity": {
            "ID": 0,
            "CreatedDate": "synthetic-example",
            "LastUpdateDate": "synthetic-example",
            "DeletedDate": "synthetic-example",
            "IdentityUUID": "synthetic-example",
            "ATUser_ID": 0,
            "CreatedBy-ATUser_ID": 0,
            "Channel": "email",
            "Stream": "auth",
            "Status": "PendingDNS",
            "Name": "synthetic-example",
            "FromName": "synthetic-example",
            "FromAddress": "synthetic-example",
            "DomainName": "synthetic-example",
            "ReturnPathDomain": "synthetic-example",
            "DKIMSelector": "synthetic-example",
            "DKIMPublicKey": "synthetic-example",
            "DKIMPrivateKeyEnvironmentKey": "synthetic-example",
            "VerificationToken": "synthetic-example",
            "DNSExpectedPayload": [],
            "DNSLastCheckPayload": [],
            "DNSLastCheckTime": "synthetic-example",
            "LastVerifiedTime": "synthetic-example",
            "LastVerifiedBy-ATUser_ID": 0,
            "ATUser_Alias": "synthetic-example"
        },
        "DNSRecords": [],
        "DKIMPrivateKeyEnvironmentKey": "FAKE_DKIM_ENVIRONMENT_KEY",
        "DKIMPrivateKeyOneTime": "FAKE_PRIVATE_KEY_PLACEHOLDER"
    }
}
תיעוד נקודת קצה קריא למכונה
POST

/v1/external_messaging/set_identity_verify_dns

#
Checks DNS records for an email sender identity and marks it verified when required records are present.

פרמטרים

שםסוגחובהברירת מחדלתיאור
identityID int לא 0 Sender identity ID.
isWritingRequest bool לא false Must be true to record the DNS check.
דוגמת בקשה (cURL)
curl --request POST \
  'https://he.appointmenttrader.com/v1/external_messaging/set_identity_verify_dns' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'identityID={{identityID}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

ערך מוחזר

JSON
See the shared response schema and synthetic example.
שדות התגובה
שדהסוגחובהתיאור
$external_messaging_set_identity_verify_dns_Response כן
$.oneOf[0] כן
$.oneOf[0].allOf[0]object כן
$.oneOf[0].allOf[0].RequestUserAliasstring כן
$.oneOf[0].allOf[0].RequestPathstring | null כן
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" כן
$.oneOf[0].allOf[0].ResponseCodeinteger כן
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage לא
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage לא
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring לא
$.oneOf[0].allOf[1]object כן
$.oneOf[0].allOf[1].Payloadobject כן
$.oneOf[0].allOf[1].Payload.Succeeded = true כן
$.oneOf[0].allOf[1].Payload.Statusstring ["PendingDNS","Verified"] כן
$.oneOf[0].allOf[1].Payload.DNSRecordsarray כן
$.oneOf[0].allOf[1].Payload.DNSRecords[]object לא
$.oneOf[0].allOf[1].Payload.DNSRecords[].keystring ["ownership","dkim","dmarc","return_path","mta_sts","tls_reporting"] כן
$.oneOf[0].allOf[1].Payload.DNSRecords[].labelstring כן
$.oneOf[0].allOf[1].Payload.DNSRecords[].typestring ["TXT","MX"] כן
$.oneOf[0].allOf[1].Payload.DNSRecords[].hoststring כן
$.oneOf[0].allOf[1].Payload.DNSRecords[].valuestring כן
$.oneOf[0].allOf[1].Payload.DNSRecords[].requiredboolean כן
$.oneOf[0].allOf[1].Payload.DNSRecords[].statusstring ["pending","verified","missing","advisory"] כן
$.oneOf[0].allOf[1].Payload.DNSRecords[].observedValuestring לא
$.oneOf[1]object כן
$.oneOf[1].RequestUserAliasstring כן
$.oneOf[1].RequestPathstring | null כן
$.oneOf[1].RequestStatus = "Failed" כן
$.oneOf[1].ResponseCodeinteger כן
$.oneOf[1].ResponseMessageAPIResponseMessage כן
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null כן
$.oneOf[1].ResponseMessage.oneOf[1]array כן
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage לא
$.oneOf[1].ResponseMessage.oneOf[2]object כן
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage לא
$.oneOf[1].RequestImpersonatedByUserAliasstring לא
דוגמת תגובה
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/external_messaging/set_identity_verify_dns",
    "RequestUserAlias": "example-user",
    "Payload": {
        "Succeeded": true,
        "Status": "PendingDNS",
        "DNSRecords": []
    }
}
תיעוד נקודת קצה קריא למכונה
POST

/v1/external_messaging/set_send

#
Queues an external message. Phase one supports email only. Production email requires a verified sender identity and is charged after the first-party MTA records smtp_accepted. Sandbox messages are free and do not submit to the MTA.

פרמטרים

שםסוגחובהברירת מחדלתיאור
channel string לא "email" Channel. Phase one supports email.
identityID int לא 0 Sender identity ID.
to string לא "" Comma-separated recipient email addresses.
subject string לא "" Message subject.
htmlBody string לא "" HTML body.
textBody string לא "" Plain text body.
stream string לא "transactional" Email stream: auth, transactional, community, bulk, or sandbox.
mode string לא "sandbox" sandbox or production.
fundingAccountID int לא 0 Optional per-message AT funding account override.
isWritingRequest bool לא false Must be true to queue the message.
דוגמת בקשה (cURL)
curl --request POST \
  'https://he.appointmenttrader.com/v1/external_messaging/set_send' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'channel={{channel}}' \
  --data-urlencode 'identityID={{identityID}}' \
  --data-urlencode 'to={{to}}' \
  --data-urlencode 'subject={{subject}}' \
  --data-urlencode 'htmlBody={{htmlBody}}' \
  --data-urlencode 'textBody={{textBody}}' \
  --data-urlencode 'stream={{stream}}' \
  --data-urlencode 'mode={{mode}}' \
  --data-urlencode 'fundingAccountID={{fundingAccountID}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

ערך מוחזר

JSON
See the shared response schema and synthetic example.
שדות התגובה
שדהסוגחובהתיאור
$external_messaging_set_send_Response כן
$.oneOf[0] כן
$.oneOf[0].allOf[0]object כן
$.oneOf[0].allOf[0].RequestUserAliasstring כן
$.oneOf[0].allOf[0].RequestPathstring | null כן
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" כן
$.oneOf[0].allOf[0].ResponseCodeinteger כן
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage לא
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage לא
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring לא
$.oneOf[0].allOf[1]object כן
$.oneOf[0].allOf[1].Payloadobject כן
$.oneOf[0].allOf[1].Payload.Succeeded = true כן
$.oneOf[0].allOf[1].Payload.Message כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0]object כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].IDDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].ID.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].ID.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].CreatedDatestring כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].LastUpdateDatestring כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].DeletedDate כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].DeletedDate.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].DeletedDate.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].MessageUUIDstring כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].ATUser_IDDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].ATUser_ID.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].ATUser_ID.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].ImpersonatedBy-ATUser_ID כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].ImpersonatedBy-ATUser_ID.anyOf[0]DatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].ImpersonatedBy-ATUser_ID.anyOf[0].oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].ImpersonatedBy-ATUser_ID.anyOf[0].oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].ImpersonatedBy-ATUser_ID.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].Channel = "email" כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].Streamstring ["auth","transactional","community","bulk","sandbox"] כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].Modestring ["sandbox","production"] כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].Statusstring ["Queued","Sending","Sent","Deferred","Suppressed","Failed"] כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].ATExternalMessagingIdentities_ID כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].ATExternalMessagingIdentities_ID.anyOf[0]DatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].ATExternalMessagingIdentities_ID.anyOf[0].oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].ATExternalMessagingIdentities_ID.anyOf[0].oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].ATExternalMessagingIdentities_ID.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].Funding-ATAccounts_ID כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].Funding-ATAccounts_ID.anyOf[0]DatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].Funding-ATAccounts_ID.anyOf[0].oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].Funding-ATAccounts_ID.anyOf[0].oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].Funding-ATAccounts_ID.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].Settlement-ATAccountsLedger_ID כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].Settlement-ATAccountsLedger_ID.anyOf[0]DatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].Settlement-ATAccountsLedger_ID.anyOf[0].oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].Settlement-ATAccountsLedger_ID.anyOf[0].oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].Settlement-ATAccountsLedger_ID.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].ATAPIAccessLog_ID כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].ATAPIAccessLog_ID.anyOf[0]DatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].ATAPIAccessLog_ID.anyOf[0].oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].ATAPIAccessLog_ID.anyOf[0].oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].ATAPIAccessLog_ID.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].Subject כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].Subject.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].Subject.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].RecipientsPayload כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].RecipientsPayload.anyOf[0]object כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].RecipientsPayload.anyOf[0].toarray כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].RecipientsPayload.anyOf[0].to[]string לא
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].RecipientsPayload.anyOf[1] = "" כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].RecipientsPayload.anyOf[2] = null כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].ContentPayload כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].ContentPayload.anyOf[0]object כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].ContentPayload.anyOf[0].htmlBodystring כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].ContentPayload.anyOf[0].textBodystring כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].ContentPayload.anyOf[1] = "" כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].ContentPayload.anyOf[2] = null כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].HeadersPayload כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].HeadersPayload.anyOf[0]object כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].HeadersPayload.anyOf[0].Fromstring כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].HeadersPayload.anyOf[0].X-AT-External-Messaging-Streamstring ["auth","transactional","community","bulk","sandbox"] כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].HeadersPayload.anyOf[0].List-Unsubscribestring לא
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].HeadersPayload.anyOf[0].List-Unsubscribe-Post = "List-Unsubscribe=One-Click" לא
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].HeadersPayload.anyOf[1] = "" כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].HeadersPayload.anyOf[2] = null כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].PriceAmountDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].PriceAmount.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].PriceAmount.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].PriceUnit כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].PriceUnit.anyOf[0]string ["USD","Traderpoint"] כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].PriceUnit.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].RecipientCountDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].RecipientCount.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].RecipientCount.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].AttemptCountDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].AttemptCount.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].AttemptCount.oneOf[1]string כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].NextAttemptDate כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].NextAttemptDate.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].NextAttemptDate.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].QueuedDate כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].QueuedDate.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].QueuedDate.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].SentDate כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].SentDate.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].SentDate.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].LastEventDate כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].LastEventDate.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].LastEventDate.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].ProviderMessageID כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].ProviderMessageID.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].ProviderMessageID.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].FailureReason כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].FailureReason.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].FailureReason.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].FromAddress כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].FromAddress.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].FromAddress.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].DomainName כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].DomainName.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].DomainName.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].ATUser_Alias כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].ATUser_Alias.anyOf[0]string כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[0].ATUser_Alias.anyOf[1]null כן
$.oneOf[0].allOf[1].Payload.Message.anyOf[1] = false כן
$.oneOf[1]object כן
$.oneOf[1].RequestUserAliasstring כן
$.oneOf[1].RequestPathstring | null כן
$.oneOf[1].RequestStatus = "Failed" כן
$.oneOf[1].ResponseCodeinteger כן
$.oneOf[1].ResponseMessageAPIResponseMessage כן
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null כן
$.oneOf[1].ResponseMessage.oneOf[1]array כן
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage לא
$.oneOf[1].ResponseMessage.oneOf[2]object כן
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage לא
$.oneOf[1].RequestImpersonatedByUserAliasstring לא
דוגמת תגובה
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/external_messaging/set_send",
    "RequestUserAlias": "example-user",
    "Payload": {
        "Succeeded": true,
        "Message": {
            "ID": 0,
            "CreatedDate": "synthetic-example",
            "LastUpdateDate": "synthetic-example",
            "DeletedDate": "synthetic-example",
            "MessageUUID": "synthetic-example",
            "ATUser_ID": 0,
            "ImpersonatedBy-ATUser_ID": 0,
            "Channel": "email",
            "Stream": "auth",
            "Mode": "sandbox",
            "Status": "Queued",
            "ATExternalMessagingIdentities_ID": 0,
            "Funding-ATAccounts_ID": 0,
            "Settlement-ATAccountsLedger_ID": 0,
            "ATAPIAccessLog_ID": 0,
            "Subject": "synthetic-example",
            "RecipientsPayload": {
                "to": []
            },
            "ContentPayload": {
                "htmlBody": "synthetic-example",
                "textBody": "synthetic-example"
            },
            "HeadersPayload": {
                "From": "synthetic-example",
                "X-AT-External-Messaging-Stream": "auth"
            },
            "PriceAmount": 0,
            "PriceUnit": "USD",
            "RecipientCount": 0,
            "AttemptCount": 0,
            "NextAttemptDate": "synthetic-example",
            "QueuedDate": "synthetic-example",
            "SentDate": "synthetic-example",
            "LastEventDate": "synthetic-example",
            "ProviderMessageID": "synthetic-example",
            "FailureReason": "synthetic-example",
            "FromAddress": "synthetic-example",
            "DomainName": "synthetic-example",
            "ATUser_Alias": "synthetic-example"
        }
    }
}
תיעוד נקודת קצה קריא למכונה
POST

/v1/external_messaging/set_suppression

#
Adds a user-level suppression for a recipient.

פרמטרים

שםסוגחובהברירת מחדלתיאור
channel string לא "email" Channel. Phase one supports email.
recipient string לא "" Recipient email address.
type string לא "manual" Suppression type.
reason string לא "" Operator or application reason.
isWritingRequest bool לא false Must be true to create the suppression.
דוגמת בקשה (cURL)
curl --request POST \
  'https://he.appointmenttrader.com/v1/external_messaging/set_suppression' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'channel={{channel}}' \
  --data-urlencode 'recipient={{recipient}}' \
  --data-urlencode 'type={{type}}' \
  --data-urlencode 'reason={{reason}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

ערך מוחזר

JSON
See the shared response schema and synthetic example.
שדות התגובה
שדהסוגחובהתיאור
$external_messaging_set_suppression_Response כן
$.oneOf[0] כן
$.oneOf[0].allOf[0]object כן
$.oneOf[0].allOf[0].RequestUserAliasstring כן
$.oneOf[0].allOf[0].RequestPathstring | null כן
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" כן
$.oneOf[0].allOf[0].ResponseCodeinteger כן
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage לא
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object כן
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage לא
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring לא
$.oneOf[0].allOf[1]object כן
$.oneOf[0].allOf[1].Payloadobject כן
$.oneOf[0].allOf[1].Payload.Succeeded = true כן
$.oneOf[0].allOf[1].Payload.SuppressionIDDatabaseInteger כןInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.SuppressionID.oneOf[0]integer כן
$.oneOf[0].allOf[1].Payload.SuppressionID.oneOf[1]string כן
$.oneOf[1]object כן
$.oneOf[1].RequestUserAliasstring כן
$.oneOf[1].RequestPathstring | null כן
$.oneOf[1].RequestStatus = "Failed" כן
$.oneOf[1].ResponseCodeinteger כן
$.oneOf[1].ResponseMessageAPIResponseMessage כן
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null כן
$.oneOf[1].ResponseMessage.oneOf[1]array כן
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage לא
$.oneOf[1].ResponseMessage.oneOf[2]object כן
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage לא
$.oneOf[1].RequestImpersonatedByUserAliasstring לא
דוגמת תגובה
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/external_messaging/set_suppression",
    "RequestUserAlias": "example-user",
    "Payload": {
        "Succeeded": true,
        "SuppressionID": 0
    }
}
תיעוד נקודת קצה קריא למכונה