Баримт бичиг / API лавлах
Эрсдэл
Залилан, эрсдэлийн дохио.
GET/v1/workspaces/{workspaceId}/partners/{partnerId}/risk
Risk score and open events of one partner (partner detail panel).
Шаардлагатай API түлхүүрийн хамрах хүрээ: partners.read
Параметр (2)
| Нэр | Байрлал | Төрөл | Заавал | Тайлбар |
|---|
workspaceId | path | string | тийм | |
partnerId | path | string | тийм | |
Хариу: 200 PartnerRiskDto
GET/v1/workspaces/{workspaceId}/risk/events
List risk events: severity first, then last detection (R49).
Шаардлагатай API түлхүүрийн хамрах хүрээ: partners.read
Параметр (10)
| Нэр | Байрлал | Төрөл | Заавал | Тайлбар |
|---|
workspaceId | path | string | тийм | |
status | query | string | | Comma list of `open` (default), `resolved`, `expired`, `shadow`, or `all`. |
severity | query | string | | |
ruleKey | query | string | | |
partnerId | query | string | | |
groupId | query | string | | |
search | query | string | | Partner name contains. |
interval | query | string | | `24h`, `7d`, `30d`, `90d`: last detection within. |
page | query | integer (int32) | | |
pageSize | query | integer (int32) | | |
Хариу: 200 RiskEventDto[]
POST/v1/workspaces/{workspaceId}/risk/events/bulk-resolve
Resolve up to 100 events as safe, one transaction each; returns a result per id.
Шаардлагатай API түлхүүрийн хамрах хүрээ: partners.write
Параметр (1)
| Нэр | Байрлал | Төрөл | Заавал | Тайлбар |
|---|
workspaceId | path | string | тийм | |
Хүсэлтийн бие (BulkBody)
| Нэр | Төрөл | Заавал | Тайлбар |
|---|
action | string | тийм | `approve` or `reject`. |
partnerIds | string[] | тийм | |
groupId | string | | |
tagIds | array | | |
tagNames | array | | |
rejectionReason | string | | |
rejectionNote | string | | |
reapplicationTimeframe | string | | |
flagForFraud | boolean | | |
flagForFraudReason | string | | |
Хариу: 200 BulkResult[]
GET/v1/workspaces/{workspaceId}/risk/events/{eventId}
One event with evidence, score lines and held commissions.
Шаардлагатай API түлхүүрийн хамрах хүрээ: partners.read
Параметр (2)
| Нэр | Байрлал | Төрөл | Заавал | Тайлбар |
|---|
workspaceId | path | string | тийм | |
eventId | path | string | тийм | |
Хариу: 200 RiskEventDetail
POST/v1/workspaces/{workspaceId}/risk/events/{eventId}/commissions
Mark the event's held commissions fraud or canceled (all or a selection); the event stays open until resolved or the partner is banned.
Шаардлагатай API түлхүүрийн хамрах хүрээ: partners.write
Параметр (2)
| Нэр | Байрлал | Төрөл | Заавал | Тайлбар |
|---|
workspaceId | path | string | тийм | |
eventId | path | string | тийм | |
Хүсэлтийн бие (MarkBody)
| Нэр | Төрөл | Заавал | Тайлбар |
|---|
commissionIds | array | | `cm_...` ids; every one must be held by this event. |
all | boolean | | |
status | string | тийм | `fraud` or `canceled`. |
applyToRelationship | boolean | | Spec 24 R32: the status follows the (customer, partner) relationship. |
Хариу: 200 MarkOut
POST/v1/workspaces/{workspaceId}/risk/events/{eventId}/reopen
Reopen a safe resolution made in the last 30 days.
Шаардлагатай API түлхүүрийн хамрах хүрээ: partners.write
Параметр (2)
| Нэр | Байрлал | Төрөл | Заавал | Тайлбар |
|---|
workspaceId | path | string | тийм | |
eventId | path | string | тийм | |
Хариу: 200 RiskEventDetail
POST/v1/workspaces/{workspaceId}/risk/events/{eventId}/resolve
Resolve as safe: held commissions return to pending, the evidence is remembered.
Шаардлагатай API түлхүүрийн хамрах хүрээ: partners.write
Параметр (2)
| Нэр | Байрлал | Төрөл | Заавал | Тайлбар |
|---|
workspaceId | path | string | тийм | |
eventId | path | string | тийм | |
Хүсэлтийн бие (ResolveBody)
| Нэр | Төрөл | Заавал | Тайлбар |
|---|
note | string | | |
excludeFromRisk | boolean | | Also exclude the partner from future monitoring (`exclude_from_risk`). |
Хариу: 200 RiskEventDetail
GET/v1/workspaces/{workspaceId}/risk/referral-sources
Banned referral patterns and the paid-traffic allow list.
Шаардлагатай API түлхүүрийн хамрах хүрээ: partners.read
Параметр (1)
| Нэр | Байрлал | Төрөл | Заавал | Тайлбар |
|---|
workspaceId | path | string | тийм | |
Хариу: 200 SourceDto[]
POST/v1/workspaces/{workspaceId}/risk/referral-sources
Add a pattern (* wildcard); at most 200 per program.
Шаардлагатай API түлхүүрийн хамрах хүрээ: partners.write
Параметр (1)
| Нэр | Байрлал | Төрөл | Заавал | Тайлбар |
|---|
workspaceId | path | string | тийм | |
Хүсэлтийн бие (SourceBody)
| Нэр | Төрөл | Заавал | Тайлбар |
|---|
pattern | string | тийм | |
kind | string | тийм | |
Хариу: 201 SourceDto
DELETE/v1/workspaces/{workspaceId}/risk/referral-sources/{sourceId}
Remove a pattern.
Шаардлагатай API түлхүүрийн хамрах хүрээ: partners.write
Параметр (2)
| Нэр | Байрлал | Төрөл | Заавал | Тайлбар |
|---|
workspaceId | path | string | тийм | |
sourceId | path | string | тийм | |
Хариу: 204
GET/v1/workspaces/{workspaceId}/risk/rules
The thirteen rules with their effective parameters.
Шаардлагатай API түлхүүрийн хамрах хүрээ: partners.read
Параметр (1)
| Нэр | Байрлал | Төрөл | Заавал | Тайлбар |
|---|
workspaceId | path | string | тийм | |
Хариу: 200 RuleDto[]
PUT/v1/workspaces/{workspaceId}/risk/rules
Update one rule. Disabling resolves its open events and releases their commissions.
Шаардлагатай API түлхүүрийн хамрах хүрээ: partners.write
Параметр (1)
| Нэр | Байрлал | Төрөл | Заавал | Тайлбар |
|---|
workspaceId | path | string | тийм | |
Хүсэлтийн бие (RuleBody)
| Нэр | Төрөл | Заавал | Тайлбар |
|---|
ruleKey | string | тийм | |
enabled | boolean | | |
params | object | | Partial object: only the listed parameters change. |
mode | string | | `live` or `shadow` (dry run, R51f). |
Хариу: 200 RuleDto
GET/v1/workspaces/{workspaceId}/risk/settings
Program risk thresholds (defaults when never changed).
Шаардлагатай API түлхүүрийн хамрах хүрээ: partners.read
Параметр (1)
| Нэр | Байрлал | Төрөл | Заавал | Тайлбар |
|---|
workspaceId | path | string | тийм | |
Хариу: 200 SettingsDto
PUT/v1/workspaces/{workspaceId}/risk/settings
Change the thresholds; the cached score and holding flag of open events are recomputed.
Шаардлагатай API түлхүүрийн хамрах хүрээ: partners.write
Параметр (1)
| Нэр | Байрлал | Төрөл | Заавал | Тайлбар |
|---|
workspaceId | path | string | тийм | |
Хүсэлтийн бие (SettingsBody)
| Нэр | Төрөл | Заавал | Тайлбар |
|---|
holdMinSeverity | string | | |
payoutBlockScore | integer (int32) | | |
eventTtlDays | integer (int32) | | |
autoCancelSelfReferral | boolean | | |
autoBanOnScore | integer (int32) | | A number sets it, `null` clears it; omit to keep. |
Хариу: 200 SettingsDto
GET/v1/workspaces/{workspaceId}/risk/summary
Header badge numbers of the risk tab.
Шаардлагатай API түлхүүрийн хамрах хүрээ: partners.read
Параметр (1)
| Нэр | Байрлал | Төрөл | Заавал | Тайлбар |
|---|
workspaceId | path | string | тийм | |
Хариу: 200 SummaryDto