Référence de l’API infractions

Rechercher dans tous les points de terminaison

/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.

Paramètres

Nom	Type	Obligatoire	Valeur par défaut	Description
`typeID`	`int`	`Oui`	`—`	Active infraction type.
`userAlias`	`string`	`Oui`	`—`	Reported user's alias. Self-reporting is not allowed.
`incidentDate`	`string`	`Non`	`""`	Incident date in YYYY-MM-DD format; empty uses today for the estimate until a date is selected.
`subjectTransactionSource`	`string`	`Non`	`""`	Required for transaction-based types: transaction or custom_article.
`subjectTransactionID`	`int`	`Non`	`0`	Required canonical transaction ID for transaction-based types.

Exemple de requête (cURL)

curl --get \
  'https://fr.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}}'

Retour

JSON

See the shared response schema and synthetic example.

Champs de réponse

Champ	Type	Obligatoire
`$`	`infractions_get_bounty_estimate_Response`	`Oui`
`$.oneOf[0]`		`Oui`
`$.oneOf[0].allOf[0]`	`object`	`Oui`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`Oui`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`Oui`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`Oui`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]`	`array`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`Non`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]`	`object`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`Non`
`$.oneOf[0].allOf[0].RequestImpersonatedByUserAlias`	`string`	`Non`
`$.oneOf[0].allOf[1]`	`object`	`Oui`
`$.oneOf[0].allOf[1].Payload`	`object`	`Oui`
`$.oneOf[0].allOf[1].Payload.amountCents`	`integer`	`Oui`
`$.oneOf[0].allOf[1].Payload.currency`	`= "USD"`	`Oui`
`$.oneOf[0].allOf[1].Payload.formattedAmount`	`string`	`Oui`
`$.oneOf[1]`	`object`	`Oui`
`$.oneOf[1].RequestUserAlias`	`string`	`Oui`
`$.oneOf[1].RequestPath`	`string \| null`	`Oui`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`Oui`
`$.oneOf[1].ResponseCode`	`integer`	`Oui`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`Oui`
`$.oneOf[1].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Oui`
`$.oneOf[1].ResponseMessage.oneOf[1]`	`array`	`Oui`
`$.oneOf[1].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`Non`
`$.oneOf[1].ResponseMessage.oneOf[2]`	`object`	`Oui`
`$.oneOf[1].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`Non`
`$.oneOf[1].RequestImpersonatedByUserAlias`	`string`	`Non`

Exemple de réponse

{
    "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"
    }
}

Documentation du point de terminaison lisible par machine

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.

Paramètres

Nom	Type	Obligatoire	Valeur par défaut	Description
`start`	`int`	`Non`	`0`	Non-negative offset; negative values use zero.

Exemple de requête (cURL)

curl --get \
  'https://fr.appointmenttrader.com/v1/infractions/get_my_reports' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'start={{start}}'

Retour

JSON

See the shared response schema and synthetic example.

Champs de réponse

Champ	Type	Obligatoire
`$`	`infractions_get_my_reports_Response`	`Oui`
`$.oneOf[0]`		`Oui`
`$.oneOf[0].allOf[0]`	`object`	`Oui`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`Oui`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`Oui`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`Oui`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]`	`array`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`Non`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]`	`object`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`Non`
`$.oneOf[0].allOf[0].RequestImpersonatedByUserAlias`	`string`	`Non`
`$.oneOf[0].allOf[1]`	`object`	`Oui`
`$.oneOf[0].allOf[1].Payload`	`object`	`Oui`
`$.oneOf[0].allOf[1].Payload.reports`	`array`	`Oui`
`$.oneOf[0].allOf[1].Payload.reports[]`	`object`	`Non`
`$.oneOf[0].allOf[1].Payload.reports[].reportID`	`integer`	`Oui`
`$.oneOf[0].allOf[1].Payload.reports[].caseID`	`integer`	`Oui`
`$.oneOf[0].allOf[1].Payload.reports[].reportedUserID`	`integer`	`Oui`
`$.oneOf[0].allOf[1].Payload.reports[].typeName`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.reports[].createdDate`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.reports[].status`	`string ["Open","Confirmed","Warning","Rejected","Merged"]`	`Oui`
`$.oneOf[0].allOf[1].Payload.reports[].chatID`	`integer`	`Oui`
`$.oneOf[0].allOf[1].Payload.start`	`integer`	`Oui`
`$.oneOf[0].allOf[1].Payload.hasMore`	`boolean`	`Oui`
`$.oneOf[0].allOf[1].Payload.nextStart`		`Oui`
`$.oneOf[0].allOf[1].Payload.nextStart.anyOf[0]`	`integer`	`Oui`
`$.oneOf[0].allOf[1].Payload.nextStart.anyOf[1]`	`null`	`Oui`
`$.oneOf[1]`	`object`	`Oui`
`$.oneOf[1].RequestUserAlias`	`string`	`Oui`
`$.oneOf[1].RequestPath`	`string \| null`	`Oui`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`Oui`
`$.oneOf[1].ResponseCode`	`integer`	`Oui`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`Oui`
`$.oneOf[1].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Oui`
`$.oneOf[1].ResponseMessage.oneOf[1]`	`array`	`Oui`
`$.oneOf[1].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`Non`
`$.oneOf[1].ResponseMessage.oneOf[2]`	`object`	`Oui`
`$.oneOf[1].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`Non`
`$.oneOf[1].RequestImpersonatedByUserAlias`	`string`	`Non`

Exemple de réponse

{
    "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
    }
}

Documentation du point de terminaison lisible par machine

GET

/v1/infractions/get_options

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

Paramètres

Nom	Type	Obligatoire	Valeur par défaut	Description
`admin`	`bool`	`Non`	`false`	Include inactive types and administration data; requires RefundAppointments.

Exemple de requête (cURL)

curl --get \
  'https://fr.appointmenttrader.com/v1/infractions/get_options' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'admin={{admin}}'

Retour

JSON

See the shared response schema and synthetic example.

Champs de réponse

Champ	Type	Obligatoire	Description
`$`	`infractions_get_options_Response`	`Oui`
`$.oneOf[0]`		`Oui`
`$.oneOf[0].allOf[0]`	`object`	`Oui`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`Oui`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`Oui`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`Oui`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]`	`array`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`Non`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]`	`object`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`Non`
`$.oneOf[0].allOf[0].RequestImpersonatedByUserAlias`	`string`	`Non`
`$.oneOf[0].allOf[1]`	`object`	`Oui`
`$.oneOf[0].allOf[1].Payload`	`object`	`Oui`
`$.oneOf[0].allOf[1].Payload.types`	`array`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[]`	`object`	`Non`
`$.oneOf[0].allOf[1].Payload.types[].ID`	`DatabaseInteger`	`Oui`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.types[].ID.oneOf[0]`	`integer`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].ID.oneOf[1]`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].Slug`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].Status`	`string ["Draft","Active","Retired"]`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].SortOrder`	`DatabaseInteger`	`Oui`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.types[].SortOrder.oneOf[0]`	`integer`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].SortOrder.oneOf[1]`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].CurrentVersionID`		`Oui`
`$.oneOf[0].allOf[1].Payload.types[].CurrentVersionID.anyOf[0]`	`DatabaseInteger`	`Oui`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.types[].CurrentVersionID.anyOf[0].oneOf[0]`	`integer`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].CurrentVersionID.anyOf[0].oneOf[1]`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].CurrentVersionID.anyOf[1]`	`null`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].CreatedDate`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].VersionNumber`	`DatabaseInteger`	`Oui`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.types[].VersionNumber.oneOf[0]`	`integer`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].VersionNumber.oneOf[1]`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].config`	`object`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].config.name`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].config.description`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].config.evidenceGuidance`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].config.subject`	`string ["seller","transaction","listing"]`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].config.referenceRequired`		`Oui`
`$.oneOf[0].allOf[1].Payload.types[].config.referenceRequired.oneOf[0]`	`boolean`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].config.referenceRequired.oneOf[1]`	`integer [0,1]`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].config.penaltyMode`	`string ["warning","fixed","annual_sales","transaction_amount"]`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].config.penaltyPermission`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].config.bountyEnabled`		`Oui`
`$.oneOf[0].allOf[1].Payload.types[].config.bountyEnabled.oneOf[0]`	`boolean`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].config.bountyEnabled.oneOf[1]`	`integer [0,1]`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].config.bountyBasisPoints`	`integer`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].config.buyerPosingAllowed`		`Oui`
`$.oneOf[0].allOf[1].Payload.types[].config.buyerPosingAllowed.oneOf[0]`	`boolean`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].config.buyerPosingAllowed.oneOf[1]`	`integer [0,1]`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].config.translations`		`Oui`
`$.oneOf[0].allOf[1].Payload.types[].config.translations.anyOf[0]`	`object`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].config.translations.anyOf[0].*`	`object`	`Non`
`$.oneOf[0].allOf[1].Payload.types[].config.translations.anyOf[0].*.name`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].config.translations.anyOf[0].*.description`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].config.translations.anyOf[0].*.evidenceGuidance`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].config.translations.anyOf[1]`	`= []`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].config.seedKey`	`string`	`Non`
`$.oneOf[0].allOf[1].Payload.types[].config.penaltyMultiplier`	`= 3`	`Non`
`$.oneOf[0].allOf[1].Payload.types[].defaultPenaltyValue`		`Oui`
`$.oneOf[0].allOf[1].Payload.types[].defaultPenaltyValue.anyOf[0]`	`DatabaseNumber`	`Oui`	Numeric value; MySQL reads can serialize numbers as numeric strings.
`$.oneOf[0].allOf[1].Payload.types[].defaultPenaltyValue.anyOf[0].oneOf[0]`	`number`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].defaultPenaltyValue.anyOf[0].oneOf[1]`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].defaultPenaltyValue.anyOf[1]`	`null`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].reporterBountyBasisPoints`	`integer`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].rawConfig`	`object`	`Non`
`$.oneOf[0].allOf[1].Payload.types[].rawConfig.name`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].rawConfig.description`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].rawConfig.evidenceGuidance`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].rawConfig.subject`	`string ["seller","transaction","listing"]`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].rawConfig.referenceRequired`		`Oui`
`$.oneOf[0].allOf[1].Payload.types[].rawConfig.referenceRequired.oneOf[0]`	`boolean`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].rawConfig.referenceRequired.oneOf[1]`	`integer [0,1]`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].rawConfig.penaltyMode`	`string ["warning","fixed","annual_sales","transaction_amount"]`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].rawConfig.penaltyPermission`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].rawConfig.bountyEnabled`		`Oui`
`$.oneOf[0].allOf[1].Payload.types[].rawConfig.bountyEnabled.oneOf[0]`	`boolean`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].rawConfig.bountyEnabled.oneOf[1]`	`integer [0,1]`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].rawConfig.bountyBasisPoints`	`integer`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].rawConfig.buyerPosingAllowed`		`Oui`
`$.oneOf[0].allOf[1].Payload.types[].rawConfig.buyerPosingAllowed.oneOf[0]`	`boolean`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].rawConfig.buyerPosingAllowed.oneOf[1]`	`integer [0,1]`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].rawConfig.translations`		`Oui`
`$.oneOf[0].allOf[1].Payload.types[].rawConfig.translations.anyOf[0]`	`object`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].rawConfig.translations.anyOf[0].*`	`object`	`Non`
`$.oneOf[0].allOf[1].Payload.types[].rawConfig.translations.anyOf[0].*.name`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].rawConfig.translations.anyOf[0].*.description`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].rawConfig.translations.anyOf[0].*.evidenceGuidance`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].rawConfig.translations.anyOf[1]`	`= []`	`Oui`
`$.oneOf[0].allOf[1].Payload.types[].rawConfig.seedKey`	`string`	`Non`
`$.oneOf[0].allOf[1].Payload.types[].rawConfig.penaltyMultiplier`	`= 3`	`Non`
`$.oneOf[0].allOf[1].Payload.permissions`	`array`	`Oui`
`$.oneOf[0].allOf[1].Payload.permissions[]`	`object`	`Non`
`$.oneOf[0].allOf[1].Payload.permissions[].Name`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.permissions[].Description`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.permissions[].DefaultSettingPayload`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.overrides`	`array`	`Oui`
`$.oneOf[0].allOf[1].Payload.overrides[]`	`object`	`Non`
`$.oneOf[0].allOf[1].Payload.overrides[].ID`	`DatabaseInteger`	`Oui`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.overrides[].ID.oneOf[0]`	`integer`	`Oui`
`$.oneOf[0].allOf[1].Payload.overrides[].ID.oneOf[1]`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.overrides[].UserID`	`DatabaseInteger`	`Oui`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.overrides[].UserID.oneOf[0]`	`integer`	`Oui`
`$.oneOf[0].allOf[1].Payload.overrides[].UserID.oneOf[1]`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.overrides[].TypeID`	`DatabaseInteger`	`Oui`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.overrides[].TypeID.oneOf[0]`	`integer`	`Oui`
`$.oneOf[0].allOf[1].Payload.overrides[].TypeID.oneOf[1]`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.overrides[].BountyBasisPoints`	`DatabaseInteger`	`Oui`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.overrides[].BountyBasisPoints.oneOf[0]`	`integer`	`Oui`
`$.oneOf[0].allOf[1].Payload.overrides[].BountyBasisPoints.oneOf[1]`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.overrides[].UpdatedByUserID`	`DatabaseInteger`	`Oui`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.overrides[].UpdatedByUserID.oneOf[0]`	`integer`	`Oui`
`$.oneOf[0].allOf[1].Payload.overrides[].UpdatedByUserID.oneOf[1]`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.overrides[].LastUpdateDate`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.audit`	`array`	`Oui`
`$.oneOf[0].allOf[1].Payload.audit[]`	`object`	`Non`
`$.oneOf[0].allOf[1].Payload.audit[].ID`	`DatabaseInteger`	`Oui`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.audit[].ID.oneOf[0]`	`integer`	`Oui`
`$.oneOf[0].allOf[1].Payload.audit[].ID.oneOf[1]`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.audit[].CaseID`	`= null`	`Oui`
`$.oneOf[0].allOf[1].Payload.audit[].TypeID`		`Oui`
`$.oneOf[0].allOf[1].Payload.audit[].TypeID.anyOf[0]`	`DatabaseInteger`	`Oui`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.audit[].TypeID.anyOf[0].oneOf[0]`	`integer`	`Oui`
`$.oneOf[0].allOf[1].Payload.audit[].TypeID.anyOf[0].oneOf[1]`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.audit[].TypeID.anyOf[1]`	`null`	`Oui`
`$.oneOf[0].allOf[1].Payload.audit[].ActorUserID`	`DatabaseInteger`	`Oui`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.audit[].ActorUserID.oneOf[0]`	`integer`	`Oui`
`$.oneOf[0].allOf[1].Payload.audit[].ActorUserID.oneOf[1]`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.audit[].EventName`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.audit[].Payload`	`string (application/json)`	`Oui`
`$.oneOf[0].allOf[1].Payload.audit[].Payload`	`(JSON décodé)`	`Oui`
`$.oneOf[0].allOf[1].Payload.audit[].Payload.oneOf[0]`	`object`	`Oui`
`$.oneOf[0].allOf[1].Payload.audit[].Payload.oneOf[0].versionID`	`integer`	`Oui`
`$.oneOf[0].allOf[1].Payload.audit[].Payload.oneOf[0].status`	`string ["Draft","Active","Retired"]`	`Oui`
`$.oneOf[0].allOf[1].Payload.audit[].Payload.oneOf[0].sortOrder`	`integer`	`Oui`
`$.oneOf[0].allOf[1].Payload.audit[].Payload.oneOf[1]`	`object`	`Oui`
`$.oneOf[0].allOf[1].Payload.audit[].Payload.oneOf[1].hunterID`	`integer`	`Oui`
`$.oneOf[0].allOf[1].Payload.audit[].Payload.oneOf[1].basisPoints`		`Oui`
`$.oneOf[0].allOf[1].Payload.audit[].Payload.oneOf[1].basisPoints.anyOf[0]`	`integer`	`Oui`
`$.oneOf[0].allOf[1].Payload.audit[].Payload.oneOf[1].basisPoints.anyOf[1]`	`null`	`Oui`
`$.oneOf[0].allOf[1].Payload.audit[].CreatedDate`	`string`	`Oui`
`$.oneOf[1]`	`object`	`Oui`
`$.oneOf[1].RequestUserAlias`	`string`	`Oui`
`$.oneOf[1].RequestPath`	`string \| null`	`Oui`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`Oui`
`$.oneOf[1].ResponseCode`	`integer`	`Oui`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`Oui`
`$.oneOf[1].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Oui`
`$.oneOf[1].ResponseMessage.oneOf[1]`	`array`	`Oui`
`$.oneOf[1].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`Non`
`$.oneOf[1].ResponseMessage.oneOf[2]`	`object`	`Oui`
`$.oneOf[1].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`Non`
`$.oneOf[1].RequestImpersonatedByUserAlias`	`string`	`Non`

Exemple de réponse

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/infractions/get_options",
    "RequestUserAlias": "example-user",
    "Payload": {
        "types": [],
        "permissions": [],
        "overrides": [],
        "audit": []
    }
}

Documentation du point de terminaison lisible par machine

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.

Paramètres

Nom	Type	Obligatoire	Valeur par défaut	Description
`listingID`	`int`	`Non`	`0`	Listing identifier, or zero.
`transactionID`	`int`	`Non`	`0`	Transaction identifier, or zero.
`chatID`	`int`	`Non`	`0`	Source chat accessible to the reporter, or zero.
`userID`	`int`	`Non`	`0`	Reported user to preselect, or zero.
`subjectTransactionSource`	`string`	`Non`	`""`	Optional exact transaction source, transaction or custom_article; does not alter the reported user.
`subjectTransactionID`	`int`	`Non`	`0`	Canonical transaction ID paired with its source.

Exemple de requête (cURL)

curl --get \
  'https://fr.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}}'

Retour

JSON

See the shared response schema and synthetic example.

Champs de réponse

Champ	Type	Obligatoire	Description
`$`	`infractions_get_report_context_Response`	`Oui`
`$.oneOf[0]`		`Oui`
`$.oneOf[0].allOf[0]`	`object`	`Oui`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`Oui`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`Oui`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`Oui`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]`	`array`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`Non`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]`	`object`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`Non`
`$.oneOf[0].allOf[0].RequestImpersonatedByUserAlias`	`string`	`Non`
`$.oneOf[0].allOf[1]`	`object`	`Oui`
`$.oneOf[0].allOf[1].Payload`	`InfractionReportContext`	`Oui`
`$.oneOf[0].allOf[1].Payload.oneOf[0]`	`object`	`Oui`
`$.oneOf[0].allOf[1].Payload.oneOf[0].chatID`	`integer`	`Non`
`$.oneOf[0].allOf[1].Payload.oneOf[0].chatName`	`string`	`Non`
`$.oneOf[0].allOf[1].Payload.oneOf[0].listingID`		`Non`
`$.oneOf[0].allOf[1].Payload.oneOf[0].listingID.anyOf[0]`	`DatabaseInteger`	`Non`	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`	`Non`
`$.oneOf[0].allOf[1].Payload.oneOf[0].listingID.anyOf[0].oneOf[1]`	`string`	`Non`
`$.oneOf[0].allOf[1].Payload.oneOf[0].listingID.anyOf[1]`	`null`	`Non`
`$.oneOf[0].allOf[1].Payload.oneOf[0].transactionID`	`DatabaseInteger`	`Non`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.oneOf[0].transactionID.oneOf[0]`	`integer`	`Non`
`$.oneOf[0].allOf[1].Payload.oneOf[0].transactionID.oneOf[1]`	`string`	`Non`
`$.oneOf[0].allOf[1].Payload.oneOf[0].sellerID`	`DatabaseInteger`	`Non`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.oneOf[0].sellerID.oneOf[0]`	`integer`	`Non`
`$.oneOf[0].allOf[1].Payload.oneOf[0].sellerID.oneOf[1]`	`string`	`Non`
`$.oneOf[0].allOf[1].Payload.oneOf[0].sellerAlias`	`string`	`Non`
`$.oneOf[0].allOf[1].Payload.oneOf[0].subjectTransaction`		`Non`
`$.oneOf[0].allOf[1].Payload.oneOf[0].subjectTransaction.anyOf[0]`	`object`	`Non`
`$.oneOf[0].allOf[1].Payload.oneOf[0].subjectTransaction.anyOf[0].source`	`string ["transaction","custom_article"]`	`Oui`
`$.oneOf[0].allOf[1].Payload.oneOf[0].subjectTransaction.anyOf[0].id`	`integer`	`Oui`
`$.oneOf[0].allOf[1].Payload.oneOf[0].subjectTransaction.anyOf[0].amountCents`	`integer`	`Oui`
`$.oneOf[0].allOf[1].Payload.oneOf[0].subjectTransaction.anyOf[0].date`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.oneOf[0].subjectTransaction.anyOf[0].label`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.oneOf[0].subjectTransaction.anyOf[0].status`	`string ["PENDING","COMPLETED","RECORDED"]`	`Oui`
`$.oneOf[0].allOf[1].Payload.oneOf[0].subjectTransaction.anyOf[0].formattedAmount`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.oneOf[0].subjectTransaction.anyOf[1]`	`null`	`Non`
`$.oneOf[0].allOf[1].Payload.oneOf[1]`	`= []`	`Oui`
`$.oneOf[1]`	`object`	`Oui`
`$.oneOf[1].RequestUserAlias`	`string`	`Oui`
`$.oneOf[1].RequestPath`	`string \| null`	`Oui`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`Oui`
`$.oneOf[1].ResponseCode`	`integer`	`Oui`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`Oui`
`$.oneOf[1].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Oui`
`$.oneOf[1].ResponseMessage.oneOf[1]`	`array`	`Oui`
`$.oneOf[1].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`Non`
`$.oneOf[1].ResponseMessage.oneOf[2]`	`object`	`Oui`
`$.oneOf[1].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`Non`
`$.oneOf[1].RequestImpersonatedByUserAlias`	`string`	`Non`

Exemple de réponse

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/infractions/get_report_context",
    "RequestUserAlias": "example-user",
    "Payload": []
}

Documentation du point de terminaison lisible par machine

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.

Paramètres

Nom	Type	Obligatoire	Valeur par défaut	Description
`referenceType`	`string`	`Oui`	`—`	post_link, bid, appointment, transaction, or custom_article.
`referenceID`	`int`	`Non`	`0`	Exact identifier in the selected namespace; positive except for post_link, which uses postLink.
`postLink`	`string`	`Non`	`""`	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.

Exemple de requête (cURL)

curl --get \
  'https://fr.appointmenttrader.com/v1/infractions/get_report_transactions' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'referenceType={{referenceType}}' \
  --data-urlencode 'referenceID={{referenceID}}' \
  --data-urlencode 'postLink={{postLink}}'

Retour

JSON

See the shared response schema and synthetic example.

Champs de réponse

Champ	Type	Obligatoire
`$`	`infractions_get_report_transactions_Response`	`Oui`
`$.oneOf[0]`		`Oui`
`$.oneOf[0].allOf[0]`	`object`	`Oui`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`Oui`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`Oui`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`Oui`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]`	`array`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`Non`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]`	`object`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`Non`
`$.oneOf[0].allOf[0].RequestImpersonatedByUserAlias`	`string`	`Non`
`$.oneOf[0].allOf[1]`	`object`	`Oui`
`$.oneOf[0].allOf[1].Payload`	`object`	`Oui`
`$.oneOf[0].allOf[1].Payload.transactions`	`array`	`Oui`
`$.oneOf[0].allOf[1].Payload.transactions[]`	`object`	`Non`
`$.oneOf[0].allOf[1].Payload.transactions[].source`	`string ["transaction","custom_article"]`	`Oui`
`$.oneOf[0].allOf[1].Payload.transactions[].id`	`integer`	`Oui`
`$.oneOf[0].allOf[1].Payload.transactions[].amountCents`	`integer`	`Oui`
`$.oneOf[0].allOf[1].Payload.transactions[].date`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.transactions[].label`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.transactions[].status`	`string ["PENDING","COMPLETED","RECORDED"]`	`Oui`
`$.oneOf[0].allOf[1].Payload.transactions[].formattedAmount`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.hasMore`	`boolean`	`Oui`
`$.oneOf[1]`	`object`	`Oui`
`$.oneOf[1].RequestUserAlias`	`string`	`Oui`
`$.oneOf[1].RequestPath`	`string \| null`	`Oui`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`Oui`
`$.oneOf[1].ResponseCode`	`integer`	`Oui`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`Oui`
`$.oneOf[1].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Oui`
`$.oneOf[1].ResponseMessage.oneOf[1]`	`array`	`Oui`
`$.oneOf[1].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`Non`
`$.oneOf[1].ResponseMessage.oneOf[2]`	`object`	`Oui`
`$.oneOf[1].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`Non`
`$.oneOf[1].RequestImpersonatedByUserAlias`	`string`	`Non`

Exemple de réponse

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/infractions/get_report_transactions",
    "RequestUserAlias": "example-user",
    "Payload": {
        "transactions": [],
        "hasMore": false
    }
}

Documentation du point de terminaison lisible par machine

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.

Paramètres

Nom	Type	Obligatoire	Valeur par défaut	Description
`submissionKey`	`string`	`Oui`	`—`	Stable unique retry identifier, 16-80 alphanumeric, underscore or hyphen characters.
`reportJson`	`string`	`Oui`	`—`	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`	`Non`	`false`	Must be true to submit.

Exemple de requête (cURL)

curl --request POST \
  'https://fr.appointmenttrader.com/v1/infractions/set_report' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'submissionKey={{submissionKey}}' \
  --data-urlencode 'reportJson={{reportJson}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

Retour

JSON

See the shared response schema and synthetic example.

Paramètres: reportJson

Champ	Type	Obligatoire	Description
`reportJson`	`string (application/json)`	`Oui`
`reportJson`	`object (JSON décodé)`	`Oui`
`reportJson.userID`	`integer`	`Non`
`reportJson.userAlias`	`string`	`Non`
`reportJson.sellerID`	`integer`	`Non`
`reportJson.sellerAlias`	`string`	`Non`
`reportJson.incidentDate`	`string`	`Oui`
`reportJson.description`	`string`	`Oui`
`reportJson.evidence`	`string`	`Non`
`reportJson.references`	`array`	`Non`
`reportJson.references[]`	`object`	`Non`
`reportJson.references[].type`	`string ["seller","transaction","listing","chat","custom_article"]`	`Oui`
`reportJson.references[].id`	`integer`	`Oui`
`reportJson.mediaIDs`	`array`	`Non`
`reportJson.mediaIDs[]`	`DatabaseInteger`	`Non`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`reportJson.mediaIDs[].oneOf[0]`	`integer`	`Non`
`reportJson.mediaIDs[].oneOf[1]`	`string`	`Non`
`reportJson.typeID`	`integer`	`Oui`
`reportJson.subjectTransactionSource`	`string ["transaction","custom_article"]`	`Non`
`reportJson.subjectTransactionID`	`integer`	`Non`

Champs de réponse

Champ	Type	Obligatoire
`$`	`infractions_set_report_Response`	`Oui`
`$.oneOf[0]`		`Oui`
`$.oneOf[0].allOf[0]`	`object`	`Oui`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`Oui`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`Oui`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`Oui`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]`	`array`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`Non`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]`	`object`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`Non`
`$.oneOf[0].allOf[0].RequestImpersonatedByUserAlias`	`string`	`Non`
`$.oneOf[0].allOf[1]`	`object`	`Oui`
`$.oneOf[0].allOf[1].Payload`	`object`	`Oui`
`$.oneOf[0].allOf[1].Payload.caseID`	`integer`	`Oui`
`$.oneOf[0].allOf[1].Payload.chatID`	`integer`	`Oui`
`$.oneOf[1]`	`object`	`Oui`
`$.oneOf[1].RequestUserAlias`	`string`	`Oui`
`$.oneOf[1].RequestPath`	`string \| null`	`Oui`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`Oui`
`$.oneOf[1].ResponseCode`	`integer`	`Oui`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`Oui`
`$.oneOf[1].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Oui`
`$.oneOf[1].ResponseMessage.oneOf[1]`	`array`	`Oui`
`$.oneOf[1].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`Non`
`$.oneOf[1].ResponseMessage.oneOf[2]`	`object`	`Oui`
`$.oneOf[1].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`Non`
`$.oneOf[1].RequestImpersonatedByUserAlias`	`string`	`Non`

Exemple de réponse

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/infractions/set_report",
    "RequestUserAlias": "example-user",
    "Payload": {
        "caseID": 0,
        "chatID": 0
    }
}

Documentation du point de terminaison lisible par machine