مرجع API لـ infractions | 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://ar.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].RequestUserAlias`	`string`	`نعم`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`نعم`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`نعم`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`نعم`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`
`$.oneOf[0].allOf[1]`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload.amountCents`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.currency`	`= "USD"`	`نعم`
`$.oneOf[0].allOf[1].Payload.formattedAmount`	`string`	`نعم`
`$.oneOf[1]`	`object`	`نعم`
`$.oneOf[1].RequestUserAlias`	`string`	`نعم`
`$.oneOf[1].RequestPath`	`string \| null`	`نعم`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`نعم`
`$.oneOf[1].ResponseCode`	`integer`	`نعم`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`

مثال استجابة

{
    "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://ar.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].RequestUserAlias`	`string`	`نعم`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`نعم`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`نعم`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`نعم`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`
`$.oneOf[0].allOf[1]`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload.reports`	`array`	`نعم`
`$.oneOf[0].allOf[1].Payload.reports[]`	`object`	`لا`
`$.oneOf[0].allOf[1].Payload.reports[].reportID`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.reports[].caseID`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.reports[].reportedUserID`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.reports[].typeName`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.reports[].createdDate`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.reports[].status`	`string ["Open","Confirmed","Warning","Rejected","Merged"]`	`نعم`
`$.oneOf[0].allOf[1].Payload.reports[].chatID`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.start`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.hasMore`	`boolean`	`نعم`
`$.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].RequestUserAlias`	`string`	`نعم`
`$.oneOf[1].RequestPath`	`string \| null`	`نعم`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`نعم`
`$.oneOf[1].ResponseCode`	`integer`	`نعم`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`

مثال استجابة

{
    "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://ar.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].RequestUserAlias`	`string`	`نعم`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`نعم`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`نعم`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`نعم`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`
`$.oneOf[0].allOf[1]`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload.types`	`array`	`نعم`
`$.oneOf[0].allOf[1].Payload.types[]`	`object`	`لا`
`$.oneOf[0].allOf[1].Payload.types[].ID`	`DatabaseInteger`	`نعم`	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[].Slug`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.types[].Status`	`string ["Draft","Active","Retired"]`	`نعم`
`$.oneOf[0].allOf[1].Payload.types[].SortOrder`	`DatabaseInteger`	`نعم`	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[].CreatedDate`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.types[].VersionNumber`	`DatabaseInteger`	`نعم`	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[].config`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload.types[].config.name`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.types[].config.description`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.types[].config.evidenceGuidance`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.types[].config.subject`	`string ["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.penaltyMode`	`string ["warning","fixed","annual_sales","transaction_amount"]`	`نعم`
`$.oneOf[0].allOf[1].Payload.types[].config.penaltyPermission`	`string`	`نعم`
`$.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.bountyBasisPoints`	`integer`	`نعم`
`$.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].*.name`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.types[].config.translations.anyOf[0].*.description`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.types[].config.translations.anyOf[0].*.evidenceGuidance`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.types[].config.translations.anyOf[1]`	`= []`	`نعم`
`$.oneOf[0].allOf[1].Payload.types[].config.seedKey`	`string`	`لا`
`$.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[].reporterBountyBasisPoints`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.types[].rawConfig`	`object`	`لا`
`$.oneOf[0].allOf[1].Payload.types[].rawConfig.name`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.types[].rawConfig.description`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.types[].rawConfig.evidenceGuidance`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.types[].rawConfig.subject`	`string ["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.penaltyMode`	`string ["warning","fixed","annual_sales","transaction_amount"]`	`نعم`
`$.oneOf[0].allOf[1].Payload.types[].rawConfig.penaltyPermission`	`string`	`نعم`
`$.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.bountyBasisPoints`	`integer`	`نعم`
`$.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].*.name`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.types[].rawConfig.translations.anyOf[0].*.description`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.types[].rawConfig.translations.anyOf[0].*.evidenceGuidance`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.types[].rawConfig.translations.anyOf[1]`	`= []`	`نعم`
`$.oneOf[0].allOf[1].Payload.types[].rawConfig.seedKey`	`string`	`لا`
`$.oneOf[0].allOf[1].Payload.types[].rawConfig.penaltyMultiplier`	`= 3`	`لا`
`$.oneOf[0].allOf[1].Payload.permissions`	`array`	`نعم`
`$.oneOf[0].allOf[1].Payload.permissions[]`	`object`	`لا`
`$.oneOf[0].allOf[1].Payload.permissions[].Name`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.permissions[].Description`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.permissions[].DefaultSettingPayload`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.overrides`	`array`	`نعم`
`$.oneOf[0].allOf[1].Payload.overrides[]`	`object`	`لا`
`$.oneOf[0].allOf[1].Payload.overrides[].ID`	`DatabaseInteger`	`نعم`	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[].UserID`	`DatabaseInteger`	`نعم`	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[].TypeID`	`DatabaseInteger`	`نعم`	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[].BountyBasisPoints`	`DatabaseInteger`	`نعم`	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[].UpdatedByUserID`	`DatabaseInteger`	`نعم`	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[].LastUpdateDate`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.audit`	`array`	`نعم`
`$.oneOf[0].allOf[1].Payload.audit[]`	`object`	`لا`
`$.oneOf[0].allOf[1].Payload.audit[].ID`	`DatabaseInteger`	`نعم`	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[].ActorUserID`	`DatabaseInteger`	`نعم`	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[].EventName`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.audit[].Payload`	`string (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].versionID`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.audit[].Payload.oneOf[0].status`	`string ["Draft","Active","Retired"]`	`نعم`
`$.oneOf[0].allOf[1].Payload.audit[].Payload.oneOf[0].sortOrder`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.audit[].Payload.oneOf[1]`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload.audit[].Payload.oneOf[1].hunterID`	`integer`	`نعم`
`$.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[].CreatedDate`	`string`	`نعم`
`$.oneOf[1]`	`object`	`نعم`
`$.oneOf[1].RequestUserAlias`	`string`	`نعم`
`$.oneOf[1].RequestPath`	`string \| null`	`نعم`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`نعم`
`$.oneOf[1].ResponseCode`	`integer`	`نعم`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`

مثال استجابة

{
    "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://ar.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].RequestUserAlias`	`string`	`نعم`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`نعم`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`نعم`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`نعم`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`
`$.oneOf[0].allOf[1]`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload`	`InfractionReportContext`	`نعم`
`$.oneOf[0].allOf[1].Payload.oneOf[0]`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload.oneOf[0].chatID`	`integer`	`لا`
`$.oneOf[0].allOf[1].Payload.oneOf[0].chatName`	`string`	`لا`
`$.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].transactionID`	`DatabaseInteger`	`لا`	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].sellerID`	`DatabaseInteger`	`لا`	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].sellerAlias`	`string`	`لا`
`$.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].source`	`string ["transaction","custom_article"]`	`نعم`
`$.oneOf[0].allOf[1].Payload.oneOf[0].subjectTransaction.anyOf[0].id`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.oneOf[0].subjectTransaction.anyOf[0].amountCents`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.oneOf[0].subjectTransaction.anyOf[0].date`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.oneOf[0].subjectTransaction.anyOf[0].label`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.oneOf[0].subjectTransaction.anyOf[0].status`	`string ["PENDING","COMPLETED","RECORDED"]`	`نعم`
`$.oneOf[0].allOf[1].Payload.oneOf[0].subjectTransaction.anyOf[0].formattedAmount`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.oneOf[0].subjectTransaction.anyOf[1]`	`null`	`لا`
`$.oneOf[0].allOf[1].Payload.oneOf[1]`	`= []`	`نعم`
`$.oneOf[1]`	`object`	`نعم`
`$.oneOf[1].RequestUserAlias`	`string`	`نعم`
`$.oneOf[1].RequestPath`	`string \| null`	`نعم`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`نعم`
`$.oneOf[1].ResponseCode`	`integer`	`نعم`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`

مثال استجابة

{
    "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://ar.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].RequestUserAlias`	`string`	`نعم`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`نعم`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`نعم`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`نعم`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`
`$.oneOf[0].allOf[1]`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload.transactions`	`array`	`نعم`
`$.oneOf[0].allOf[1].Payload.transactions[]`	`object`	`لا`
`$.oneOf[0].allOf[1].Payload.transactions[].source`	`string ["transaction","custom_article"]`	`نعم`
`$.oneOf[0].allOf[1].Payload.transactions[].id`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.transactions[].amountCents`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.transactions[].date`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.transactions[].label`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.transactions[].status`	`string ["PENDING","COMPLETED","RECORDED"]`	`نعم`
`$.oneOf[0].allOf[1].Payload.transactions[].formattedAmount`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.hasMore`	`boolean`	`نعم`
`$.oneOf[1]`	`object`	`نعم`
`$.oneOf[1].RequestUserAlias`	`string`	`نعم`
`$.oneOf[1].RequestPath`	`string \| null`	`نعم`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`نعم`
`$.oneOf[1].ResponseCode`	`integer`	`نعم`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`

مثال استجابة

{
    "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://ar.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

الحقل	النوع	مطلوب	الوصف
`reportJson`	`string (application/json)`	`نعم`
`reportJson`	`object (JSON بعد فك الترميز)`	`نعم`
`reportJson.userID`	`integer`	`لا`
`reportJson.userAlias`	`string`	`لا`
`reportJson.sellerID`	`integer`	`لا`
`reportJson.sellerAlias`	`string`	`لا`
`reportJson.incidentDate`	`string`	`نعم`
`reportJson.description`	`string`	`نعم`
`reportJson.evidence`	`string`	`لا`
`reportJson.references`	`array`	`لا`
`reportJson.references[]`	`object`	`لا`
`reportJson.references[].type`	`string ["seller","transaction","listing","chat","custom_article"]`	`نعم`
`reportJson.references[].id`	`integer`	`نعم`
`reportJson.mediaIDs`	`array`	`لا`
`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.typeID`	`integer`	`نعم`
`reportJson.subjectTransactionSource`	`string ["transaction","custom_article"]`	`لا`
`reportJson.subjectTransactionID`	`integer`	`لا`

حقول الاستجابة

الحقل	النوع	مطلوب
`$`	`infractions_set_report_Response`	`نعم`
`$.oneOf[0]`		`نعم`
`$.oneOf[0].allOf[0]`	`object`	`نعم`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`نعم`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`نعم`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`نعم`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`نعم`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`
`$.oneOf[0].allOf[1]`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload.caseID`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.chatID`	`integer`	`نعم`
`$.oneOf[1]`	`object`	`نعم`
`$.oneOf[1].RequestUserAlias`	`string`	`نعم`
`$.oneOf[1].RequestPath`	`string \| null`	`نعم`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`نعم`
`$.oneOf[1].ResponseCode`	`integer`	`نعم`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`

مثال استجابة

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

توثيق نقطة النهاية القابل للقراءة آليًا