AT AppointmentTrader
Войти
Сейчас онлайн  

/v1/infractions/

Private user-infraction reporting, staff adjudication and bounty administration.
GET

/v1/infractions/get_bounty_estimate

#
Estimate the maximum USD bounty for a signed-in reporter using the current type, reported user's penalty permission and reporter's bounty rate. Assumes a full contribution share; staff decides the actual outcome and may award no bounty. Does not create a report or financial entry.

Параметры

ИмяТипОбязательноПо умолчаниюОписание
typeID int Да — Active infraction type.
userAlias string Да — Reported user's alias. Self-reporting is not allowed.
incidentDate string Нет "" Incident date in YYYY-MM-DD format; empty uses today for the estimate until a date is selected.
subjectTransactionSource string Нет "" Required for transaction-based types: transaction or custom_article.
subjectTransactionID int Нет 0 Required canonical transaction ID for transaction-based types.
Пример запроса (cURL) 
curl --get \
  'https://ru.appointmenttrader.com/v1/infractions/get_bounty_estimate' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'typeID={{typeID}}' \
  --data-urlencode 'userAlias={{userAlias}}' \
  --data-urlencode 'incidentDate={{incidentDate}}' \
  --data-urlencode 'subjectTransactionSource={{subjectTransactionSource}}' \
  --data-urlencode 'subjectTransactionID={{subjectTransactionID}}'

Возвращает

JSON
See the shared response schema and synthetic example.
Поля ответа
ПолеТипОбязательноОписание
$infractions_get_bounty_estimate_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.amountCentsinteger Да
$.oneOf[0].allOf[1].Payload.currency = "USD" Да
$.oneOf[0].allOf[1].Payload.formattedAmountstring Да
$.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/infractions/get_bounty_estimate",
    "RequestUserAlias": "example-user",
    "Payload": {
        "amountCents": 0,
        "currency": "USD",
        "formattedAmount": "synthetic-example"
    }
}
Машиночитаемая документация метода
GET

/v1/infractions/get_my_reports

#
Get only reports submitted by the acting user, including when the caller is staff. Reports against the caller are excluded. Merged reports retain their private chat and use the current case status and classification.

Параметры

ИмяТипОбязательноПо умолчаниюОписание
start int Нет 0 Non-negative offset; negative values use zero.
Пример запроса (cURL) 
curl --get \
  'https://ru.appointmenttrader.com/v1/infractions/get_my_reports' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'start={{start}}'

Возвращает

JSON
See the shared response schema and synthetic example.
Поля ответа
ПолеТипОбязательноОписание
$infractions_get_my_reports_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.reportsarray Да
$.oneOf[0].allOf[1].Payload.reports[]object Нет
$.oneOf[0].allOf[1].Payload.reports[].reportIDinteger Да
$.oneOf[0].allOf[1].Payload.reports[].caseIDinteger Да
$.oneOf[0].allOf[1].Payload.reports[].reportedUserIDinteger Да
$.oneOf[0].allOf[1].Payload.reports[].typeNamestring Да
$.oneOf[0].allOf[1].Payload.reports[].createdDatestring Да
$.oneOf[0].allOf[1].Payload.reports[].statusstring ["Open","Confirmed","Warning","Rejected","Merged"] Да
$.oneOf[0].allOf[1].Payload.reports[].chatIDinteger Да
$.oneOf[0].allOf[1].Payload.startinteger Да
$.oneOf[0].allOf[1].Payload.hasMoreboolean Да
$.oneOf[0].allOf[1].Payload.nextStart Да
$.oneOf[0].allOf[1].Payload.nextStart.anyOf[0]integer Да
$.oneOf[0].allOf[1].Payload.nextStart.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/infractions/get_my_reports",
    "RequestUserAlias": "example-user",
    "Payload": {
        "reports": [],
        "start": 0,
        "hasMore": false,
        "nextStart": 0
    }
}
Машиночитаемая документация метода
GET

/v1/infractions/get_options

#
Get reportable types or staff configuration, numeric permissions and audit history.

Параметры

ИмяТипОбязательноПо умолчаниюОписание
admin bool Нет false Include inactive types and administration data; requires RefundAppointments.
Пример запроса (cURL) 
curl --get \
  'https://ru.appointmenttrader.com/v1/infractions/get_options' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'admin={{admin}}'

Возвращает

JSON
See the shared response schema and synthetic example.
Поля ответа
ПолеТипОбязательноОписание
$infractions_get_options_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.typesarray Да
$.oneOf[0].allOf[1].Payload.types[]object Нет
$.oneOf[0].allOf[1].Payload.types[].IDDatabaseInteger ДаInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.types[].ID.oneOf[0]integer Да
$.oneOf[0].allOf[1].Payload.types[].ID.oneOf[1]string Да
$.oneOf[0].allOf[1].Payload.types[].Slugstring Да
$.oneOf[0].allOf[1].Payload.types[].Statusstring ["Draft","Active","Retired"] Да
$.oneOf[0].allOf[1].Payload.types[].SortOrderDatabaseInteger ДаInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.types[].SortOrder.oneOf[0]integer Да
$.oneOf[0].allOf[1].Payload.types[].SortOrder.oneOf[1]string Да
$.oneOf[0].allOf[1].Payload.types[].CurrentVersionID Да
$.oneOf[0].allOf[1].Payload.types[].CurrentVersionID.anyOf[0]DatabaseInteger ДаInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.types[].CurrentVersionID.anyOf[0].oneOf[0]integer Да
$.oneOf[0].allOf[1].Payload.types[].CurrentVersionID.anyOf[0].oneOf[1]string Да
$.oneOf[0].allOf[1].Payload.types[].CurrentVersionID.anyOf[1]null Да
$.oneOf[0].allOf[1].Payload.types[].CreatedDatestring Да
$.oneOf[0].allOf[1].Payload.types[].VersionNumberDatabaseInteger ДаInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.types[].VersionNumber.oneOf[0]integer Да
$.oneOf[0].allOf[1].Payload.types[].VersionNumber.oneOf[1]string Да
$.oneOf[0].allOf[1].Payload.types[].configobject Да
$.oneOf[0].allOf[1].Payload.types[].config.namestring Да
$.oneOf[0].allOf[1].Payload.types[].config.descriptionstring Да
$.oneOf[0].allOf[1].Payload.types[].config.evidenceGuidancestring Да
$.oneOf[0].allOf[1].Payload.types[].config.subjectstring ["seller","transaction","listing"] Да
$.oneOf[0].allOf[1].Payload.types[].config.referenceRequired Да
$.oneOf[0].allOf[1].Payload.types[].config.referenceRequired.oneOf[0]boolean Да
$.oneOf[0].allOf[1].Payload.types[].config.referenceRequired.oneOf[1]integer [0,1] Да
$.oneOf[0].allOf[1].Payload.types[].config.penaltyModestring ["warning","fixed","annual_sales","transaction_amount"] Да
$.oneOf[0].allOf[1].Payload.types[].config.penaltyPermissionstring Да
$.oneOf[0].allOf[1].Payload.types[].config.bountyEnabled Да
$.oneOf[0].allOf[1].Payload.types[].config.bountyEnabled.oneOf[0]boolean Да
$.oneOf[0].allOf[1].Payload.types[].config.bountyEnabled.oneOf[1]integer [0,1] Да
$.oneOf[0].allOf[1].Payload.types[].config.bountyBasisPointsinteger Да
$.oneOf[0].allOf[1].Payload.types[].config.buyerPosingAllowed Да
$.oneOf[0].allOf[1].Payload.types[].config.buyerPosingAllowed.oneOf[0]boolean Да
$.oneOf[0].allOf[1].Payload.types[].config.buyerPosingAllowed.oneOf[1]integer [0,1] Да
$.oneOf[0].allOf[1].Payload.types[].config.translations Да
$.oneOf[0].allOf[1].Payload.types[].config.translations.anyOf[0]object Да
$.oneOf[0].allOf[1].Payload.types[].config.translations.anyOf[0].*object Нет
$.oneOf[0].allOf[1].Payload.types[].config.translations.anyOf[0].*.namestring Да
$.oneOf[0].allOf[1].Payload.types[].config.translations.anyOf[0].*.descriptionstring Да
$.oneOf[0].allOf[1].Payload.types[].config.translations.anyOf[0].*.evidenceGuidancestring Да
$.oneOf[0].allOf[1].Payload.types[].config.translations.anyOf[1] = [] Да
$.oneOf[0].allOf[1].Payload.types[].config.seedKeystring Нет
$.oneOf[0].allOf[1].Payload.types[].config.penaltyMultiplier = 3 Нет
$.oneOf[0].allOf[1].Payload.types[].defaultPenaltyValue Да
$.oneOf[0].allOf[1].Payload.types[].defaultPenaltyValue.anyOf[0]DatabaseNumber ДаNumeric value; MySQL reads can serialize numbers as numeric strings.
$.oneOf[0].allOf[1].Payload.types[].defaultPenaltyValue.anyOf[0].oneOf[0]number Да
$.oneOf[0].allOf[1].Payload.types[].defaultPenaltyValue.anyOf[0].oneOf[1]string Да
$.oneOf[0].allOf[1].Payload.types[].defaultPenaltyValue.anyOf[1]null Да
$.oneOf[0].allOf[1].Payload.types[].reporterBountyBasisPointsinteger Да
$.oneOf[0].allOf[1].Payload.types[].rawConfigobject Нет
$.oneOf[0].allOf[1].Payload.types[].rawConfig.namestring Да
$.oneOf[0].allOf[1].Payload.types[].rawConfig.descriptionstring Да
$.oneOf[0].allOf[1].Payload.types[].rawConfig.evidenceGuidancestring Да
$.oneOf[0].allOf[1].Payload.types[].rawConfig.subjectstring ["seller","transaction","listing"] Да
$.oneOf[0].allOf[1].Payload.types[].rawConfig.referenceRequired Да
$.oneOf[0].allOf[1].Payload.types[].rawConfig.referenceRequired.oneOf[0]boolean Да
$.oneOf[0].allOf[1].Payload.types[].rawConfig.referenceRequired.oneOf[1]integer [0,1] Да
$.oneOf[0].allOf[1].Payload.types[].rawConfig.penaltyModestring ["warning","fixed","annual_sales","transaction_amount"] Да
$.oneOf[0].allOf[1].Payload.types[].rawConfig.penaltyPermissionstring Да
$.oneOf[0].allOf[1].Payload.types[].rawConfig.bountyEnabled Да
$.oneOf[0].allOf[1].Payload.types[].rawConfig.bountyEnabled.oneOf[0]boolean Да
$.oneOf[0].allOf[1].Payload.types[].rawConfig.bountyEnabled.oneOf[1]integer [0,1] Да
$.oneOf[0].allOf[1].Payload.types[].rawConfig.bountyBasisPointsinteger Да
$.oneOf[0].allOf[1].Payload.types[].rawConfig.buyerPosingAllowed Да
$.oneOf[0].allOf[1].Payload.types[].rawConfig.buyerPosingAllowed.oneOf[0]boolean Да
$.oneOf[0].allOf[1].Payload.types[].rawConfig.buyerPosingAllowed.oneOf[1]integer [0,1] Да
$.oneOf[0].allOf[1].Payload.types[].rawConfig.translations Да
$.oneOf[0].allOf[1].Payload.types[].rawConfig.translations.anyOf[0]object Да
$.oneOf[0].allOf[1].Payload.types[].rawConfig.translations.anyOf[0].*object Нет
$.oneOf[0].allOf[1].Payload.types[].rawConfig.translations.anyOf[0].*.namestring Да
$.oneOf[0].allOf[1].Payload.types[].rawConfig.translations.anyOf[0].*.descriptionstring Да
$.oneOf[0].allOf[1].Payload.types[].rawConfig.translations.anyOf[0].*.evidenceGuidancestring Да
$.oneOf[0].allOf[1].Payload.types[].rawConfig.translations.anyOf[1] = [] Да
$.oneOf[0].allOf[1].Payload.types[].rawConfig.seedKeystring Нет
$.oneOf[0].allOf[1].Payload.types[].rawConfig.penaltyMultiplier = 3 Нет
$.oneOf[0].allOf[1].Payload.permissionsarray Да
$.oneOf[0].allOf[1].Payload.permissions[]object Нет
$.oneOf[0].allOf[1].Payload.permissions[].Namestring Да
$.oneOf[0].allOf[1].Payload.permissions[].Descriptionstring Да
$.oneOf[0].allOf[1].Payload.permissions[].DefaultSettingPayloadstring Да
$.oneOf[0].allOf[1].Payload.overridesarray Да
$.oneOf[0].allOf[1].Payload.overrides[]object Нет
$.oneOf[0].allOf[1].Payload.overrides[].IDDatabaseInteger ДаInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.overrides[].ID.oneOf[0]integer Да
$.oneOf[0].allOf[1].Payload.overrides[].ID.oneOf[1]string Да
$.oneOf[0].allOf[1].Payload.overrides[].UserIDDatabaseInteger ДаInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.overrides[].UserID.oneOf[0]integer Да
$.oneOf[0].allOf[1].Payload.overrides[].UserID.oneOf[1]string Да
$.oneOf[0].allOf[1].Payload.overrides[].TypeIDDatabaseInteger ДаInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.overrides[].TypeID.oneOf[0]integer Да
$.oneOf[0].allOf[1].Payload.overrides[].TypeID.oneOf[1]string Да
$.oneOf[0].allOf[1].Payload.overrides[].BountyBasisPointsDatabaseInteger ДаInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.overrides[].BountyBasisPoints.oneOf[0]integer Да
$.oneOf[0].allOf[1].Payload.overrides[].BountyBasisPoints.oneOf[1]string Да
$.oneOf[0].allOf[1].Payload.overrides[].UpdatedByUserIDDatabaseInteger ДаInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.overrides[].UpdatedByUserID.oneOf[0]integer Да
$.oneOf[0].allOf[1].Payload.overrides[].UpdatedByUserID.oneOf[1]string Да
$.oneOf[0].allOf[1].Payload.overrides[].LastUpdateDatestring Да
$.oneOf[0].allOf[1].Payload.auditarray Да
$.oneOf[0].allOf[1].Payload.audit[]object Нет
$.oneOf[0].allOf[1].Payload.audit[].IDDatabaseInteger ДаInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.audit[].ID.oneOf[0]integer Да
$.oneOf[0].allOf[1].Payload.audit[].ID.oneOf[1]string Да
$.oneOf[0].allOf[1].Payload.audit[].CaseID = null Да
$.oneOf[0].allOf[1].Payload.audit[].TypeID Да
$.oneOf[0].allOf[1].Payload.audit[].TypeID.anyOf[0]DatabaseInteger ДаInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.audit[].TypeID.anyOf[0].oneOf[0]integer Да
$.oneOf[0].allOf[1].Payload.audit[].TypeID.anyOf[0].oneOf[1]string Да
$.oneOf[0].allOf[1].Payload.audit[].TypeID.anyOf[1]null Да
$.oneOf[0].allOf[1].Payload.audit[].ActorUserIDDatabaseInteger ДаInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.audit[].ActorUserID.oneOf[0]integer Да
$.oneOf[0].allOf[1].Payload.audit[].ActorUserID.oneOf[1]string Да
$.oneOf[0].allOf[1].Payload.audit[].EventNamestring Да
$.oneOf[0].allOf[1].Payload.audit[].Payloadstring (application/json) Да
$.oneOf[0].allOf[1].Payload.audit[].Payload (декодированный JSON) Да
$.oneOf[0].allOf[1].Payload.audit[].Payload.oneOf[0]object Да
$.oneOf[0].allOf[1].Payload.audit[].Payload.oneOf[0].versionIDinteger Да
$.oneOf[0].allOf[1].Payload.audit[].Payload.oneOf[0].statusstring ["Draft","Active","Retired"] Да
$.oneOf[0].allOf[1].Payload.audit[].Payload.oneOf[0].sortOrderinteger Да
$.oneOf[0].allOf[1].Payload.audit[].Payload.oneOf[1]object Да
$.oneOf[0].allOf[1].Payload.audit[].Payload.oneOf[1].hunterIDinteger Да
$.oneOf[0].allOf[1].Payload.audit[].Payload.oneOf[1].basisPoints Да
$.oneOf[0].allOf[1].Payload.audit[].Payload.oneOf[1].basisPoints.anyOf[0]integer Да
$.oneOf[0].allOf[1].Payload.audit[].Payload.oneOf[1].basisPoints.anyOf[1]null Да
$.oneOf[0].allOf[1].Payload.audit[].CreatedDatestring Да
$.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/infractions/get_options",
    "RequestUserAlias": "example-user",
    "Payload": {
        "types": [],
        "permissions": [],
        "overrides": [],
        "audit": []
    }
}
Машиночитаемая документация метода
GET

/v1/infractions/get_report_context

#
Resolve report context from a listing, participant-owned transaction, accessible chat or reported user. Chat targets use structured context or the sole other participant; ambiguous groups leave the user unselected.

Параметры

ИмяТипОбязательноПо умолчаниюОписание
listingID int Нет 0 Listing identifier, or zero.
transactionID int Нет 0 Transaction identifier, or zero.
chatID int Нет 0 Source chat accessible to the reporter, or zero.
userID int Нет 0 Reported user to preselect, or zero.
subjectTransactionSource string Нет "" Optional exact transaction source, transaction or custom_article; does not alter the reported user.
subjectTransactionID int Нет 0 Canonical transaction ID paired with its source.
Пример запроса (cURL) 
curl --get \
  'https://ru.appointmenttrader.com/v1/infractions/get_report_context' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'listingID={{listingID}}' \
  --data-urlencode 'transactionID={{transactionID}}' \
  --data-urlencode 'chatID={{chatID}}' \
  --data-urlencode 'userID={{userID}}' \
  --data-urlencode 'subjectTransactionSource={{subjectTransactionSource}}' \
  --data-urlencode 'subjectTransactionID={{subjectTransactionID}}'

Возвращает

JSON
See the shared response schema and synthetic example.
Поля ответа
ПолеТипОбязательноОписание
$infractions_get_report_context_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].PayloadInfractionReportContext Да
$.oneOf[0].allOf[1].Payload.oneOf[0]object Да
$.oneOf[0].allOf[1].Payload.oneOf[0].chatIDinteger Нет
$.oneOf[0].allOf[1].Payload.oneOf[0].chatNamestring Нет
$.oneOf[0].allOf[1].Payload.oneOf[0].listingID Нет
$.oneOf[0].allOf[1].Payload.oneOf[0].listingID.anyOf[0]DatabaseInteger НетInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.oneOf[0].listingID.anyOf[0].oneOf[0]integer Нет
$.oneOf[0].allOf[1].Payload.oneOf[0].listingID.anyOf[0].oneOf[1]string Нет
$.oneOf[0].allOf[1].Payload.oneOf[0].listingID.anyOf[1]null Нет
$.oneOf[0].allOf[1].Payload.oneOf[0].transactionIDDatabaseInteger НетInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.oneOf[0].transactionID.oneOf[0]integer Нет
$.oneOf[0].allOf[1].Payload.oneOf[0].transactionID.oneOf[1]string Нет
$.oneOf[0].allOf[1].Payload.oneOf[0].sellerIDDatabaseInteger НетInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.oneOf[0].sellerID.oneOf[0]integer Нет
$.oneOf[0].allOf[1].Payload.oneOf[0].sellerID.oneOf[1]string Нет
$.oneOf[0].allOf[1].Payload.oneOf[0].sellerAliasstring Нет
$.oneOf[0].allOf[1].Payload.oneOf[0].subjectTransaction Нет
$.oneOf[0].allOf[1].Payload.oneOf[0].subjectTransaction.anyOf[0]object Нет
$.oneOf[0].allOf[1].Payload.oneOf[0].subjectTransaction.anyOf[0].sourcestring ["transaction","custom_article"] Да
$.oneOf[0].allOf[1].Payload.oneOf[0].subjectTransaction.anyOf[0].idinteger Да
$.oneOf[0].allOf[1].Payload.oneOf[0].subjectTransaction.anyOf[0].amountCentsinteger Да
$.oneOf[0].allOf[1].Payload.oneOf[0].subjectTransaction.anyOf[0].datestring Да
$.oneOf[0].allOf[1].Payload.oneOf[0].subjectTransaction.anyOf[0].labelstring Да
$.oneOf[0].allOf[1].Payload.oneOf[0].subjectTransaction.anyOf[0].statusstring ["PENDING","COMPLETED","RECORDED"] Да
$.oneOf[0].allOf[1].Payload.oneOf[0].subjectTransaction.anyOf[0].formattedAmountstring Да
$.oneOf[0].allOf[1].Payload.oneOf[0].subjectTransaction.anyOf[1]null Нет
$.oneOf[0].allOf[1].Payload.oneOf[1] = [] Да
$.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/infractions/get_report_context",
    "RequestUserAlias": "example-user",
    "Payload": []
}
Машиночитаемая документация метода
GET

/v1/infractions/get_report_transactions

#
Resolve an exact transaction reference for a signed-in reporter, regardless of ownership. Staff verifies the connection to the reported user. Only pending/completed marketplace transactions and non-deleted recorded custom articles with valid amounts are returned.

Параметры

ИмяТипОбязательноПо умолчаниюОписание
referenceType string Да — post_link, bid, appointment, transaction, or custom_article.
referenceID int Нет 0 Exact identifier in the selected namespace; positive except for post_link, which uses postLink.
postLink string Нет "" AppointmentTrader post URL or root-relative post path, required for post_link. Resolves the viewable post's stored bid association without fetching the URL. Supports /posts/{id} and the v2 newsfeed postId route.
Пример запроса (cURL) 
curl --get \
  'https://ru.appointmenttrader.com/v1/infractions/get_report_transactions' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'referenceType={{referenceType}}' \
  --data-urlencode 'referenceID={{referenceID}}' \
  --data-urlencode 'postLink={{postLink}}'

Возвращает

JSON
See the shared response schema and synthetic example.
Поля ответа
ПолеТипОбязательноОписание
$infractions_get_report_transactions_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.transactionsarray Да
$.oneOf[0].allOf[1].Payload.transactions[]object Нет
$.oneOf[0].allOf[1].Payload.transactions[].sourcestring ["transaction","custom_article"] Да
$.oneOf[0].allOf[1].Payload.transactions[].idinteger Да
$.oneOf[0].allOf[1].Payload.transactions[].amountCentsinteger Да
$.oneOf[0].allOf[1].Payload.transactions[].datestring Да
$.oneOf[0].allOf[1].Payload.transactions[].labelstring Да
$.oneOf[0].allOf[1].Payload.transactions[].statusstring ["PENDING","COMPLETED","RECORDED"] Да
$.oneOf[0].allOf[1].Payload.transactions[].formattedAmountstring Да
$.oneOf[0].allOf[1].Payload.hasMoreboolean Да
$.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/infractions/get_report_transactions",
    "RequestUserAlias": "example-user",
    "Payload": {
        "transactions": [],
        "hasMore": false
    }
}
Машиночитаемая документация метода
POST

/v1/infractions/set_report

#
Submit a private infraction report with optional uploaded images, videos or PDFs. Attachments and later evidence-chat uploads are linked to the report and visible only to its reporter and authorized reviewers.

Параметры

ИмяТипОбязательноПо умолчаниюОписание
submissionKey string Да — Stable unique retry identifier, 16-80 alphanumeric, underscore or hyphen characters.
reportJson string Да — JSON containing typeID, userID or userAlias, incidentDate (YYYY-MM-DD), required description, optional legacy evidence text, mediaIDs [owned ATMedia IDs], references [{type: seller|transaction|listing|chat|custom_article,id}], and subjectTransactionSource/subjectTransactionID. Transaction-based types require exactly one canonical source/ID pair at submission; other internal references are optional; staff must verify configured required references before approving an adverse finding. Chat references require the reporter's current access and remain private to the reporter and case reviewers. Legacy sellerID/sellerAlias are accepted when neither canonical user field is supplied.
isWritingRequest bool Нет false Must be true to submit.
Пример запроса (cURL) 
curl --request POST \
  'https://ru.appointmenttrader.com/v1/infractions/set_report' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'submissionKey={{submissionKey}}' \
  --data-urlencode 'reportJson={{reportJson}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

Возвращает

JSON
See the shared response schema and synthetic example.
Параметры: reportJson
ПолеТипОбязательноОписание
reportJsonstring (application/json) Да
reportJsonobject (декодированный JSON) Да
reportJson.userIDinteger Нет
reportJson.userAliasstring Нет
reportJson.sellerIDinteger Нет
reportJson.sellerAliasstring Нет
reportJson.incidentDatestring Да
reportJson.descriptionstring Да
reportJson.evidencestring Нет
reportJson.referencesarray Нет
reportJson.references[]object Нет
reportJson.references[].typestring ["seller","transaction","listing","chat","custom_article"] Да
reportJson.references[].idinteger Да
reportJson.mediaIDsarray Нет
reportJson.mediaIDs[]DatabaseInteger НетInteger value; legacy MySQL reads may serialize it as a numeric string.
reportJson.mediaIDs[].oneOf[0]integer Нет
reportJson.mediaIDs[].oneOf[1]string Нет
reportJson.typeIDinteger Да
reportJson.subjectTransactionSourcestring ["transaction","custom_article"] Нет
reportJson.subjectTransactionIDinteger Нет
Поля ответа
ПолеТипОбязательноОписание
$infractions_set_report_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.caseIDinteger Да
$.oneOf[0].allOf[1].Payload.chatIDinteger Да
$.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/infractions/set_report",
    "RequestUserAlias": "example-user",
    "Payload": {
        "caseID": 0,
        "chatID": 0
    }
}
Машиночитаемая документация метода