> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.
# लेन-देन निगरानी नियम प्राप्त करें API
> Didit पर एक KYT नियम उसकी पूरी कॉन्फ़िगरेशन और निष्पादन काउंटर के साथ प्राप्त करें: रन संख्या, स्वीकृत/समीक्षाधीन/अस्वीकृत प्रतिशत, अंतिम ट्रिगर समय।
नियम प्राप्त करने के लिए API प्रॉम्प्ट
प्रॉम्प्ट को क्लिपबोर्ड पर कॉपी करें
\`Fetch one transaction-monitoring rule by uuid.
Endpoint:
GET [https://verification.didit.me/v3/transactions/rules/\{rule\_uuid}/](https://verification.didit.me/v3/transactions/rules/\{rule_uuid}/)
Authentication:
Use the x-api-key header with my Didit API key.
Behavior:
* Returns the full configuration (scope, conditions, aggregation, actions, mode, evaluation\_mode) plus execution counters: run\_count, approved/reviewed/declined/awaiting\_user counts and percentages, latest\_triggered\_at.
* Read the rule back after a create or update to confirm what is actually stored.
* 404 when the uuid does not belong to this application's non-deleted rules.\`
यहाँ पेस्ट करें
## OpenAPI
````yaml hi/openapi-25.json GET /v3/transactions/rules/{rule_uuid}/
openapi: 3.0.0
info:
version: 3.0.0
title: Didit Verification API
description: पहचान सत्यापन API। x-api-key हेडर के साथ प्रमाणीकृत करें।
servers:
- url: https://verification.didit.me
security: []
tags: []
paths:
/v3/transactions/rules/{rule_uuid}/:
parameters:
- name: rule_uuid
in: path
required: true
schema:
type: string
format: uuid
description: सूची या निर्माण से नियम का uuid।
get:
tags:
- Transactions
summary: नियम प्राप्त करें
description: >-
एक नियम को उसके संपूर्ण कॉन्फ़िगरेशन और निष्पादन काउंटरों के साथ प्राप्त
करें।
operationId: getTransactionRule
responses:
'200':
description: नियम।
content:
application/json:
schema:
$ref: '#/components/schemas/TransactionRuleDetail'
'404':
description: इस एप्लिकेशन पर ऐसा कोई नियम नहीं है।
content:
application/json:
schema:
type: object
security:
- ApiKeyAuth: []
x-codeSamples:
- lang: curl
label: curl
source: >-
curl -X GET
'https://verification.didit.me/v3/transactions/rules/RULE_UUID/' \
-H 'x-api-key: YOUR_API_KEY'
- lang: python
label: Python
source: |-
from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.transactions.rules.retrieve(
"11111111-2222-3333-4444-555555555555",
)
print(result)
- lang: javascript
label: Node.js
source: >-
import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await
didit.transactions.rules.retrieve("11111111-2222-3333-4444-555555555555");
console.log(result);
- lang: go
label: Go
source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Transactions.Rules.Retrieve(ctx, \"11111111-2222-3333-4444-555555555555\")\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)"
- lang: java
label: Java
source: >-
import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result =
client.transactions().rules().retrieve("11111111-2222-3333-4444-555555555555");
System.out.println(result);
- lang: php
label: PHP
source: >-
transactions->rules->retrieve('11111111-2222-3333-4444-555555555555');
print_r($result->toArray());
- lang: ruby
label: Ruby
source: >-
require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result =
didit.transactions.rules.retrieve("11111111-2222-3333-4444-555555555555")
puts result.to_h
- lang: csharp
label: .NET
source: >-
using System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await
client.Transactions.Rules.RetrieveAsync("11111111-2222-3333-4444-555555555555");
Console.WriteLine(JsonSerializer.Serialize(result));
components:
schemas:
TransactionRuleDetail:
type: object
properties:
uuid:
type: string
format: uuid
title:
type: string
description: >-
नियम का नाम। गैर-हटाए गए नियमों में प्रति एप्लिकेशन अद्वितीय;
डुप्लिकेट 400 लौटाते हैं।
description:
type: string
nullable: true
category:
type: string
description: >-
समूहीकरण और रिपोर्टिंग के लिए उपयोग की जाने वाली जोखिम थीम, उदाहरण
के लिए finance, aml_ctf, anomaly_detection, fatf,
device_intelligence, crypto_monitoring, travel_rule,
responsible_gaming, e_commerce।
mode:
type: string
enum:
- ACTIVE
- DISABLED
- TEST
description: >-
ACTIVE लाइव मूल्यांकन करता है। TEST नियम चलाने का मूल्यांकन और
रिकॉर्ड करता है लेकिन कभी भी स्कोर या स्थिति को प्रभावित नहीं करता
है - यह अनुशंसित शुरुआती मोड है। DISABLED को छोड़ दिया जाता है।
evaluation_mode:
type: string
enum:
- ALL
- ANY
default: ALL
description: >-
क्या प्रत्येक शर्त का मिलान होना चाहिए (ALL) या कम से कम एक का
(ANY)। जब शर्तें group_index का उपयोग करती हैं तो अनदेखा किया जाता
है।
scope:
$ref: '#/components/schemas/TransactionRuleScope'
conditions:
type: array
items:
$ref: '#/components/schemas/TransactionRuleCondition'
aggregation:
type: array
items:
$ref: '#/components/schemas/TransactionRuleAggregation'
actions:
type: array
items:
$ref: '#/components/schemas/TransactionRuleAction'
metadata:
type: object
description: नियम पर संग्रहीत फ़्री-फ़ॉर्म मेटाडेटा।
severity:
type: string
enum:
- UNKNOWN
- LOW
- MEDIUM
- HIGH
- CRITICAL
nullable: true
description: >-
लाइब्रेरी नियमों से मिलने वाली सूचनात्मक गंभीरता; कस्टम नियमों पर
सेट करने योग्य नहीं है।
source:
type: string
enum:
- PRESET
- CUSTOM
description: >-
PRESET नियम लाइब्रेरी से आते हैं (इंस्टॉल/अनइंस्टॉल, केवल-मोड
संपादन); CUSTOM नियम पूरी तरह से आपके हैं।
library_key:
type: string
nullable: true
description: स्थिर लाइब्रेरी पहचानकर्ता; कस्टम नियमों के लिए null।
latest_triggered_at:
type: string
format: date-time
nullable: true
run_count:
type: integer
description: इस नियम से कितने लेन-देन मेल खाते हैं।
approved_count:
type: integer
reviewed_count:
type: integer
declined_count:
type: integer
awaiting_user_count:
type: integer
approved_pct:
type: number
reviewed_pct:
type: number
declined_pct:
type: number
created_at:
type: string
format: date-time
updated_at:
type: string
format: date-time
TransactionRuleScope:
type: object
properties:
transaction_types:
type: array
items:
type: string
description: >-
लेन-देन के प्रकारों तक सीमित करें, उदा. finance, kyc, travel_rule,
user_event। खाली या अनुपस्थित = कोई प्रतिबंध नहीं।
directions:
type: array
items:
type: string
enum:
- INBOUND
- OUTBOUND
description: लेन-देन की दिशाओं तक सीमित करें (लिखते समय केस-इनसेंसिटिव)।
action_types:
type: array
items:
type: string
description: अपने action_type मानों तक सीमित करें, उदा. withdrawal, deposit।
description: >-
नियम किन लेन-देन पर लागू होता है। केवल ये तीन कुंजियाँ स्वीकार की जाती
हैं।
TransactionRuleCondition:
type: object
required:
- field
- operator
properties:
field:
type: string
description: >-
मूल्यांकन करने के लिए लेन-देन फ़ील्ड पाथ। मुख्य फ़ील्ड: amount,
currency, direction, action_type, score, severity, transaction_type,
payment_details, preferred_currency_amount
(amount_in_default_currency पर फ़ॉलबैक करता है),
default_currency_code, subject_country, counterparty_country,
subject_vendor_data, counterparty_vendor_data,
subject_device_fingerprint, counterparty_device_fingerprint,
subject_browser_family, subject_browser_version, subject_platform,
subject_accept_language, subject_session_age_ms, subject_ip_country,
counterparty_ip_country, subject_ip_address,
counterparty_ip_address, subject_payment_method_type,
subject_payment_method_country, subject_payment_method_fingerprint,
subject_payment_method_account_id (और counterparty_payment_method_*
समकक्ष), travel_rule_status, travel_rule_required,
travel_rule_obligations_count, counterparty_dd_status (Travel Rule
प्रतिपक्ष पर आपका निर्णय: APPROVED, RESTRICTED या BLOCKED, अपने
ब्रांड का अनुसरण करने वाली एक इकाई), counterparty_risk_level (LOW,
MEDIUM या HIGH; HIGH जब आपकी अपनी प्रतिपक्ष स्क्रीनिंग फ़्लैग की गई
हो), counterparty_jurisdiction (प्रतिपक्ष VASP का देश),
counterparty_responsiveness (RESPONSIVE, UNRESPONSIVE या UNKNOWN),
subject_days_since_previous_transaction, tags, और लेन-देन निर्माण पर
custom_properties में सबमिट की गई किसी भी कुंजी के लिए
custom_values.। देश-कोड फ़ील्ड ISO-2 या ISO-3 स्वीकार करते हैं;
तुलना से पहले दोनों पक्षों को ISO-3 में सामान्यीकृत किया जाता है।
operator:
type: string
enum:
- eq
- ne
- gt
- gte
- lt
- lte
- in
- not_in
- contains
- not_contains
- contains_any
- regex
- fuzzy_match
- exists
- is_not_empty
- is_not_null
- not_exists
- is_empty
- is_null
description: >-
तुलना ऑपरेटर। in/not_in सदस्यता का परीक्षण करते हैं (मान एक सूची या
एकल स्केलर हो सकता है)। contains/not_contains स्ट्रिंग मान के
विरुद्ध केस-असंवेदनशील सबस्ट्रिंग जाँच हैं। contains_any स्ट्रिंग्स
की एक सूची लेता है और तब मेल खाता है जब कोई भी फ़ील्ड मान का
केस-असंवेदनशील सबस्ट्रिंग हो। regex फ़ील्ड के विरुद्ध मान पैटर्न से
मेल खाता है। fuzzy_match आवश्यक `score` थ्रेशोल्ड (0-100) के साथ मान
स्ट्रिंग के विरुद्ध तुलना करता है। gt/gte/lt/lte कभी भी मेल नहीं
खाते हैं जब कोई भी पक्ष अनुपलब्ध हो। exists/is_not_empty/is_not_null
(उपनाम) और not_exists/is_empty/is_null (उपनाम) उपस्थिति जाँच हैं जो
`value` को अनदेखा करती हैं।
value:
description: >-
तुलना मान। इसका स्वरूप ऑपरेटर और value_type पर निर्भर करता है;
उपस्थिति-जाँच ऑपरेटरों के लिए इसे छोड़ दें। हर दूसरे ऑपरेटर को एक
ऐसे मान की आवश्यकता होती है जो `null` या खाली सूची न हो, अन्यथा नियम
को `400` के साथ अस्वीकार कर दिया जाता है। `contains_any` को
स्ट्रिंग्स की एक सूची की आवश्यकता होती है, और `contains`,
`not_contains` और `regex` को एकल स्ट्रिंग की आवश्यकता होती है।
value_type:
type: string
enum:
- list
- field
- relative_date
description: >-
वैकल्पिक मान व्याख्या। `list`: मान एक List UUID है और सूची की
प्रविष्टियां तुलना मान बन जाती हैं। `field`: मान एक अन्य फ़ील्ड पथ
है, जिसकी तुलना फ़ील्ड-दर-फ़ील्ड की जाती है। `relative_date`: मान एक
सापेक्ष-तिथि ऑब्जेक्ट है, उदाहरण के लिए {"direction": "past",
"unit": "days", "amount": 30}।
score:
type: number
minimum: 0
maximum: 100
description: 'जब ऑपरेटर fuzzy_match हो तब आवश्यक: 0-100 का समानता थ्रेशोल्ड।'
group_index:
type: integer
description: >-
वैकल्पिक समूहीकृत लॉजिक। जब किसी भी शर्त में group_index शामिल होता
है, तो एक ही इंडेक्स वाली शर्तें एक समूह बनाती हैं और समूहीकृत
मूल्यांकन evaluation_mode को प्रतिस्थापित करता है।
group_logic:
type: string
enum:
- AND
- OR
default: AND
description: एक समूह के भीतर स्थितियां कैसे संयोजित होती हैं।
groups_logic:
type: string
enum:
- AND
- OR
default: OR
description: >-
समूहों के बीच समूह परिणाम कैसे संयोजित होते हैं। पहली स्थिति से पढ़ा
जाता है।
description: >-
एक शर्त केवल मूल्यांकित किए जा रहे लेन-देन को पढ़ती है - यह कभी भी
एकत्रीकरण विंडो को फ़िल्टर नहीं करती है।
TransactionRuleAggregation:
type: object
required:
- value
properties:
metric:
type: string
enum:
- count
- sum
- max
- min
- avg
- distinct_count
default: count
description: >-
मिलान वाले ऐतिहासिक लेन-देन को कैसे एकत्रित किया जाता है।
unique_count को distinct_count के उपनाम के रूप में स्वीकार किया जाता
है।
field:
type: string
default: amount
description: >-
sum/max/min/avg/distinct_count द्वारा एग्रीगेट किया गया फ़ील्ड।
count के लिए अनदेखा किया गया।
operator:
type: string
enum:
- eq
- ne
- gt
- gte
- lt
- lte
default: eq
description: गणना किए गए मीट्रिक पर लागू की गई तुलना।
value:
type: number
description: थ्रेशोल्ड जिसके विरुद्ध गणना किए गए मीट्रिक की तुलना की जाती है।
window:
type: string
pattern: ^\d+(m|h|d)$
default: 1d
description: >-
लेन-देन की txn_date पर समाप्त होने वाली लुक-बैक विंडो: m (मिनट,
महीने नहीं), h (घंटे) या d (दिन), उदा. 30m, 24h, 7d, 30d।
filters:
type: object
additionalProperties: true
description: >-
यह सीमित करता है कि किन ऐतिहासिक लेन-देनों को समूहीकृत किया जाए।
कुंजियाँ कंडीशन फ़ील्ड कैटलॉग से फ़ील्ड पाथ हैं; "__current__" का
मान मूल्यांकित किए जा रहे लेन-देन पर उसी फ़ील्ड के मान पर रिज़ॉल्व
होता है (उदा. {"subject_vendor_data": "__current__"} विंडो को उसी
विषय तक सीमित करता है), और सूची मान का अर्थ सदस्यता होता है।
समूहीकृत मान के बिना रिकॉर्ड कभी भी एक साथ समूहीकृत नहीं किए जाते
हैं: जब मूल्यांकित किए जा रहे लेन-देन में किसी "__current__" फ़ील्ड
के लिए कोई मान नहीं होता है (कोई प्रतिपक्ष नहीं, कोई डिवाइस
फ़िंगरप्रिंट नहीं), तो एग्रीगेशन मेल नहीं खाता है, चाहे इसका ऑपरेटर
कुछ भी हो। फ़िल्टर केवल समानता या सदस्यता द्वारा तुलना करते हैं -
कोई lt/gte फ़िल्टर नहीं है, इसलिए "10,000 से कम के ऐतिहासिक लेन-देन"
जैसी सीमा यहाँ व्यक्त नहीं की जा सकती है। इसके बजाय सीमा को मीट्रिक
पर रखें (lt ऑपरेटर के साथ मीट्रिक max विंडो के प्रत्येक लेन-देन को
थ्रेशोल्ड से नीचे रखता है)।
description: >-
विंडो के भीतर एप्लिकेशन के ऐतिहासिक लेन-देन पर वेलोसिटी जांच।
evaluation_mode की परवाह किए बिना, नियम से मेल खाने के लिए प्रत्येक
एग्रीगेशन प्रविष्टि का मेल खाना आवश्यक है। एक एग्रीगेशन केवल विंडो को
बाधित करता है; मूल्यांकित किए जा रहे लेन-देन को स्कोप और शर्तों द्वारा
बाधित किया जाता है, इसलिए जब नियम उन्हें निर्दिष्ट करता है तो दोनों
हिस्सों पर direction, currency या transaction_type दोहराएं।
TransactionRuleAction:
oneOf:
- $ref: '#/components/schemas/TransactionRuleActionAddScore'
- $ref: '#/components/schemas/TransactionRuleActionChangeStatus'
- $ref: '#/components/schemas/TransactionRuleActionAddTags'
- $ref: '#/components/schemas/TransactionRuleActionAddNote'
- $ref: '#/components/schemas/TransactionRuleActionAddToList'
- $ref: '#/components/schemas/TransactionRuleActionOpenCase'
discriminator:
propertyName: type
mapping:
add_score: '#/components/schemas/TransactionRuleActionAddScore'
change_status: '#/components/schemas/TransactionRuleActionChangeStatus'
add_tags: '#/components/schemas/TransactionRuleActionAddTags'
add_note: '#/components/schemas/TransactionRuleActionAddNote'
add_to_list: '#/components/schemas/TransactionRuleActionAddToList'
open_case: '#/components/schemas/TransactionRuleActionOpenCase'
description: >-
एक नियम कार्रवाई। एक नियम में कई कार्रवाइयाँ हो सकती हैं; मेल खाने पर
सभी एक साथ लागू की जाती हैं। TEST मोड में नियम बिना कोई कार्रवाई लागू
किए यह रिकॉर्ड करते हैं कि वे क्या करते।
TransactionRuleActionAddScore:
type: object
required:
- type
- value
properties:
type:
type: string
enum:
- add_score
value:
type: integer
description: लेन-देन के जोखिम स्कोर में जोड़े गए अंक। नकारात्मक हो सकते हैं।
description: >-
लेन-देन के संचयी जोखिम स्कोर में अंक जोड़ें; कुल योग एप्लिकेशन के
समीक्षा/अस्वीकृति थ्रेशोल्ड के माध्यम से स्थिति तय करता है।
TransactionRuleActionChangeStatus:
type: object
required:
- type
- value
properties:
type:
type: string
enum:
- change_status
value:
type: string
enum:
- APPROVED
- IN_REVIEW
- DECLINED
- AWAITING_USER
description: >-
स्कोर की परवाह किए बिना तुरंत सेट किया जाने वाला स्टेटस। उपनाम
कुंजी: status।
workflow_id:
type: string
format: uuid
description: >-
मान AWAITING_USER होने पर आवश्यक: सत्यापन वर्कफ़्लो जिसे विषय को
पूरा करने के लिए कहा जाता है। उपनाम कुंजी: remediation_workflow_id।
नियम ट्रिगर होने पर Didit विषय के लिए एक होस्टेड रेमेडिएशन सत्र
बनाता है।
description: >-
सीधे लेन-देन की स्थिति सेट करें। मिलान किए गए नियमों में DECLINED को
हमेशा प्राथमिकता मिलती है।
TransactionRuleActionAddTags:
type: object
required:
- type
properties:
type:
type: string
enum:
- add_tags
tag_uuid:
type: string
format: uuid
description: संलग्न करने के लिए मौजूदा एप्लिकेशन टैग।
tag_name:
type: string
description: >-
संलग्न करने के लिए टैग का नाम; पहली बार उपयोग पर बनाया जाता है (बड़े
अक्षरों में संग्रहीत)। tag_uuid या tag_name प्रदान करें।
tag_color:
type: string
description: >-
हेक्साडेसिमल रंग जिसका उपयोग तब किया जाता है जब tag_name एक नया टैग
बनाता है, उदा. #007AFE।
description: मिलान किए गए लेन-देन में एक एप्लिकेशन टैग संलग्न करें।
TransactionRuleActionAddNote:
type: object
required:
- type
- note
properties:
type:
type: string
enum:
- add_note
note:
type: string
description: 'लेन-देन से जुड़ा नोट टेक्स्ट (लेखक: Rule Engine)। उपनाम कुंजी: मान।'
description: मिलान किए गए लेन-देन में एक स्वचालित विश्लेषक नोट संलग्न करें।
TransactionRuleActionAddToList:
type: object
required:
- type
- list_id
properties:
type:
type: string
enum:
- add_to_list
list_id:
type: string
format: uuid
description: वह सूची जिसमें विषय का vendor_data जोड़ना है।
description: >-
सब्जेक्ट के vendor_data को ब्लॉकलिस्ट, अनुमति सूची या कस्टम सूची में
जोड़ें।
TransactionRuleActionOpenCase:
type: object
required:
- type
properties:
type:
type: string
enum:
- open_case
blueprint:
type: string
format: uuid
description: >-
केस ब्लूप्रिंट UUID; एप्लिकेशन के डिफ़ॉल्ट ब्लूप्रिंट पर डिफ़ॉल्ट
होता है।
grouping:
type: string
enum:
- by_applicant
- by_rule_and_applicant
description: >-
क्या दोहराए गए मिलान प्रति आवेदक एक केस में शामिल होते हैं या प्रति
नियम+आवेदक एक में।
attach_matched_transaction:
type: boolean
description: मिलान किए गए लेन-देन को केस से संलग्न करें।
description: >-
जांच केस खोलें (या उसमें जोड़ें)। किसी नियम पर केवल पहली open_case
कार्रवाई लागू की जाती है।
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-api-key
description: >-
आपकी एप्लिकेशन की API कुंजी, Business Console में Developers -> API keys
से। प्राथमिक कुंजी के पास पूर्ण एक्सेस होता है। एक नामित कुंजी को स्कोप
किया जा सकता है: प्रति संसाधन none, read या write, कुछ वर्कफ़्लो या
स्वीकृत सत्रों तक सीमित, IP पतों की सूची तक सीमित, और समाप्ति तिथि तक
सीमित। 401 का अर्थ है कि कुंजी गलत है, निरस्त कर दी गई है या उसकी
समय-सीमा समाप्त हो गई है; 403 का अर्थ है कि कोई कुंजी नहीं भेजी गई थी,
कुंजी के पास इस संसाधन या कार्रवाई का एक्सेस नहीं है, या अनुरोध उसकी IP
सूची से बाहर के पते से आया था; सत्र रूट पर 404 का अर्थ है कि सत्र कुंजी
के वर्कफ़्लो या स्थितियों से बाहर है। मीडिया एक्सेस के बिना एक कुंजी को
छवि, वीडियो और PDF URL null के रूप में प्राप्त होते हैं, और सत्र write
के बिना एक कुंजी को सत्र लिंक और token null के रूप में प्राप्त होते हैं।
देखें https://docs.didit.me/console/api-keys।
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.