infractions APIリファレンス

すべてのエンドポイントを検索

/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://jp.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://jp.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://jp.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://jp.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://jp.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://jp.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
    }
}

機械可読のエンドポイントドキュメント