حل الحالة: واجهة برمجة التطبيقات

curl

curl -X POST 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/cases/c1a5e000-0000-4000-8000-000000000001/resolve/' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"resolution": "FALSE_POSITIVE", "note": "Confirmed legitimate activity after reviewing documents."}'

from didit import Didit

# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
client = Didit()

result = client.cases.resolve(
    "c1a5e000-0000-4000-8000-000000000001",
    resolution="FALSE_POSITIVE",
    note="Confirmed legitimate activity after reviewing documents.",
)
print(result)

import Didit from "@didit-protocol/sdk-node";

// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
const didit = new Didit();

const result = await didit.cases.resolve("c1a5e000-0000-4000-8000-000000000001", {
  resolution: "FALSE_POSITIVE",
  note: "Confirmed legitimate activity after reviewing documents.",
});
console.log(result);

ctx := context.Background()
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
client := didit.NewClient()

result, err := client.Cases.Resolve(ctx, "c1a5e000-0000-4000-8000-000000000001", didit.CasesResolveParams{
	Resolution: "FALSE_POSITIVE",
	Note:       didit.String("Confirmed legitimate activity after reviewing documents."),
})
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%+v\n", result)

import me.didit.Didit;
import me.didit.types.CasesResolveParams;

// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
Didit client = new Didit();

var result = client.cases().resolve("c1a5e000-0000-4000-8000-000000000001", CasesResolveParams.builder()
        .resolution(CasesResolveParams.Resolution.of("FALSE_POSITIVE"))
        .note("Confirmed legitimate activity after reviewing documents.")
        .build());
System.out.println(result);

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
$didit = new DiditClient();

$result = $didit->cases->resolve('c1a5e000-0000-4000-8000-000000000001', [
    'resolution' => 'FALSE_POSITIVE',
    'note' => 'Confirmed legitimate activity after reviewing documents.',
]);
print_r($result->toArray());

require "didit"

# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
didit = Didit::Client.new

result = didit.cases.resolve(
  "c1a5e000-0000-4000-8000-000000000001",
  resolution: "FALSE_POSITIVE",
  note: "Confirmed legitimate activity after reviewing documents."
)
puts result.to_h

using System;
using System.Text.Json;
using Didit;

// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
using var client = new DiditClient();

var result = await client.Cases.ResolveAsync("c1a5e000-0000-4000-8000-000000000001", new CasesResolveParams
{
    Resolution = "FALSE_POSITIVE",
    Note = "Confirmed legitimate activity after reviewing documents.",
});
Console.WriteLine(JsonSerializer.Serialize(result));

{
  "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "case_number": "<string>",
  "title": "<string>",
  "status": "OPEN",
  "resolution": "FALSE_POSITIVE",
  "resolution_notes": "<string>",
  "priority": "LOW",
  "source": "MANUAL",
  "tags": [
    "<string>"
  ],
  "subject": {
    "type": "user",
    "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "external_id": "<string>",
    "country": "ESP",
    "portrait": "<string>"
  },
  "assigned_to": {
    "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "full_name": "<string>",
    "email": "jsmith@example.com"
  },
  "assigned_at": "2023-11-07T05:31:56Z",
  "team": {
    "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>"
  },
  "due_at": "2023-11-07T05:31:56Z",
  "resolved_at": "2023-11-07T05:31:56Z",
  "resolved_by_email": "<string>",
  "pending_resolution": {
    "resolution": "FALSE_POSITIVE",
    "resolution_notes": "<string>",
    "maker_email": "jsmith@example.com",
    "maker_name": "<string>",
    "maker_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "maker_blueprint_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "staged_at": "2023-11-07T05:31:56Z"
  },
  "checker": {
    "member_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "email": "jsmith@example.com"
  },
  "metadata": {},
  "blueprint": {
    "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "description": "<string>",
    "assignment_method": "MANUAL",
    "assignee_pool": [
      "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    ],
    "max_active_cases": 123,
    "escalation_enabled": true,
    "transfer_enabled": true,
    "require_resolution_note": true,
    "is_active": true,
    "preset_key": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "escalation_blueprint": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "escalation_blueprint_name": "<string>",
    "four_eyes_checker_blueprint": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "four_eyes_checker_blueprint_name": "<string>",
    "content_config": {
      "checklist": {
        "enabled": true,
        "optional": true,
        "items": [
          {
            "label": "<string>",
            "order": 123
          }
        ]
      },
      "aml_control": {
        "enabled": true,
        "financial": true,
        "identity": true
      },
      "identity": {
        "enabled": true,
        "personal_information": true,
        "applicant_tags": true,
        "contact_information": true,
        "risk_overview": true,
        "poi_documents": true,
        "poa_documents": true
      },
      "verifications": {
        "enabled": true,
        "summary": true
      },
      "reporting": {
        "enabled": true,
        "fiu_reports": true
      },
      "financial": {
        "enabled": true,
        "payment_methods": true,
        "transactions": true
      }
    },
    "creation_sources": [
      {
        "kind": "aml",
        "id": "<string>",
        "name": "<string>"
      }
    ],
    "receives_escalation_from": [
      {
        "id": "<string>",
        "name": "<string>"
      }
    ],
    "updated_at": "2023-11-07T05:31:56Z",
    "version": 123,
    "default_deadline_hours": 4380
  },
  "notes": [
    {
      "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "comment": "<string>",
      "actor_email": "jsmith@example.com",
      "actor_name": "<string>",
      "mentioned_emails": [
        "jsmith@example.com"
      ],
      "is_internal": true,
      "attachments": [
        {
          "s3_key": "<string>",
          "filename": "<string>",
          "file_size": 123,
          "url": "<string>"
        }
      ],
      "tags": [
        "<string>"
      ],
      "created_at": "2023-11-07T05:31:56Z"
    }
  ],
  "events": [
    {
      "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "event_type": "CREATED",
      "actor_email": "jsmith@example.com",
      "actor_name": "<string>",
      "previous_status": "OPEN",
      "new_status": "OPEN",
      "metadata": {},
      "created_at": "2023-11-07T05:31:56Z"
    }
  ],
  "links": [
    {
      "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "linked_entity_type": "session",
      "linked_entity_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "linked_entity_summary": {},
      "created_at": "2023-11-07T05:31:56Z"
    }
  ],
  "links_count": 123,
  "notes_count": 123,
  "checklist_items": [
    {
      "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "label": "<string>",
      "is_completed": true,
      "completed_by": "jsmith@example.com",
      "completed_at": "2023-11-07T05:31:56Z",
      "order": 123
    }
  ],
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

POST

organization

{organization_id}

application

{application_id}

cases

{case_uuid}

resolve

curl

curl -X POST 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/cases/c1a5e000-0000-4000-8000-000000000001/resolve/' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"resolution": "FALSE_POSITIVE", "note": "Confirmed legitimate activity after reviewing documents."}'

from didit import Didit

# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
client = Didit()

result = client.cases.resolve(
    "c1a5e000-0000-4000-8000-000000000001",
    resolution="FALSE_POSITIVE",
    note="Confirmed legitimate activity after reviewing documents.",
)
print(result)

import Didit from "@didit-protocol/sdk-node";

// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
const didit = new Didit();

const result = await didit.cases.resolve("c1a5e000-0000-4000-8000-000000000001", {
  resolution: "FALSE_POSITIVE",
  note: "Confirmed legitimate activity after reviewing documents.",
});
console.log(result);

ctx := context.Background()
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
client := didit.NewClient()

result, err := client.Cases.Resolve(ctx, "c1a5e000-0000-4000-8000-000000000001", didit.CasesResolveParams{
	Resolution: "FALSE_POSITIVE",
	Note:       didit.String("Confirmed legitimate activity after reviewing documents."),
})
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%+v\n", result)

import me.didit.Didit;
import me.didit.types.CasesResolveParams;

// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
Didit client = new Didit();

var result = client.cases().resolve("c1a5e000-0000-4000-8000-000000000001", CasesResolveParams.builder()
        .resolution(CasesResolveParams.Resolution.of("FALSE_POSITIVE"))
        .note("Confirmed legitimate activity after reviewing documents.")
        .build());
System.out.println(result);

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
$didit = new DiditClient();

$result = $didit->cases->resolve('c1a5e000-0000-4000-8000-000000000001', [
    'resolution' => 'FALSE_POSITIVE',
    'note' => 'Confirmed legitimate activity after reviewing documents.',
]);
print_r($result->toArray());

require "didit"

# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
didit = Didit::Client.new

result = didit.cases.resolve(
  "c1a5e000-0000-4000-8000-000000000001",
  resolution: "FALSE_POSITIVE",
  note: "Confirmed legitimate activity after reviewing documents."
)
puts result.to_h

using System;
using System.Text.Json;
using Didit;

// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
using var client = new DiditClient();

var result = await client.Cases.ResolveAsync("c1a5e000-0000-4000-8000-000000000001", new CasesResolveParams
{
    Resolution = "FALSE_POSITIVE",
    Note = "Confirmed legitimate activity after reviewing documents.",
});
Console.WriteLine(JsonSerializer.Serialize(result));

{
  "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "case_number": "<string>",
  "title": "<string>",
  "status": "OPEN",
  "resolution": "FALSE_POSITIVE",
  "resolution_notes": "<string>",
  "priority": "LOW",
  "source": "MANUAL",
  "tags": [
    "<string>"
  ],
  "subject": {
    "type": "user",
    "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "external_id": "<string>",
    "country": "ESP",
    "portrait": "<string>"
  },
  "assigned_to": {
    "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "full_name": "<string>",
    "email": "jsmith@example.com"
  },
  "assigned_at": "2023-11-07T05:31:56Z",
  "team": {
    "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>"
  },
  "due_at": "2023-11-07T05:31:56Z",
  "resolved_at": "2023-11-07T05:31:56Z",
  "resolved_by_email": "<string>",
  "pending_resolution": {
    "resolution": "FALSE_POSITIVE",
    "resolution_notes": "<string>",
    "maker_email": "jsmith@example.com",
    "maker_name": "<string>",
    "maker_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "maker_blueprint_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "staged_at": "2023-11-07T05:31:56Z"
  },
  "checker": {
    "member_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "email": "jsmith@example.com"
  },
  "metadata": {},
  "blueprint": {
    "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "description": "<string>",
    "assignment_method": "MANUAL",
    "assignee_pool": [
      "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    ],
    "max_active_cases": 123,
    "escalation_enabled": true,
    "transfer_enabled": true,
    "require_resolution_note": true,
    "is_active": true,
    "preset_key": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "escalation_blueprint": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "escalation_blueprint_name": "<string>",
    "four_eyes_checker_blueprint": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "four_eyes_checker_blueprint_name": "<string>",
    "content_config": {
      "checklist": {
        "enabled": true,
        "optional": true,
        "items": [
          {
            "label": "<string>",
            "order": 123
          }
        ]
      },
      "aml_control": {
        "enabled": true,
        "financial": true,
        "identity": true
      },
      "identity": {
        "enabled": true,
        "personal_information": true,
        "applicant_tags": true,
        "contact_information": true,
        "risk_overview": true,
        "poi_documents": true,
        "poa_documents": true
      },
      "verifications": {
        "enabled": true,
        "summary": true
      },
      "reporting": {
        "enabled": true,
        "fiu_reports": true
      },
      "financial": {
        "enabled": true,
        "payment_methods": true,
        "transactions": true
      }
    },
    "creation_sources": [
      {
        "kind": "aml",
        "id": "<string>",
        "name": "<string>"
      }
    ],
    "receives_escalation_from": [
      {
        "id": "<string>",
        "name": "<string>"
      }
    ],
    "updated_at": "2023-11-07T05:31:56Z",
    "version": 123,
    "default_deadline_hours": 4380
  },
  "notes": [
    {
      "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "comment": "<string>",
      "actor_email": "jsmith@example.com",
      "actor_name": "<string>",
      "mentioned_emails": [
        "jsmith@example.com"
      ],
      "is_internal": true,
      "attachments": [
        {
          "s3_key": "<string>",
          "filename": "<string>",
          "file_size": 123,
          "url": "<string>"
        }
      ],
      "tags": [
        "<string>"
      ],
      "created_at": "2023-11-07T05:31:56Z"
    }
  ],
  "events": [
    {
      "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "event_type": "CREATED",
      "actor_email": "jsmith@example.com",
      "actor_name": "<string>",
      "previous_status": "OPEN",
      "new_status": "OPEN",
      "metadata": {},
      "created_at": "2023-11-07T05:31:56Z"
    }
  ],
  "links": [
    {
      "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "linked_entity_type": "session",
      "linked_entity_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "linked_entity_summary": {},
      "created_at": "2023-11-07T05:31:56Z"
    }
  ],
  "links_count": 123,
  "notes_count": 123,
  "checklist_items": [
    {
      "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "label": "<string>",
      "is_completed": true,
      "completed_by": "jsmith@example.com",
      "completed_at": "2023-11-07T05:31:56Z",
      "order": 123
    }
  ],
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

احسم حالة. إذا كان قالبها مقترنًا بقالب مدقِّق لـمراجعة بأربع أعين، فسيؤدي هذا الطلب إلى تجهيز الحل بدلًا من إغلاق الحالة. تحقق من الحقل pending_resolution في الاستجابة لتمييز النتيجتين.

تسمية المدقِّق

في قالب يحتوي على خطوة مدقِّق بأربع أعين، أرسل checker مع معرّف UUID للمستخدم الذي يجب أن يعتمد الحل. لا يمكن بعد ذلك أن يعتمد الحل أو يرفضه إلا ذلك العضو؛ أما غيره، بما في ذلك مفتاح API، فيتلقى 403. الحقل checker في الحالة يسمّي هذا العضو حتى يُعتمد الحل أو يُرفض، أو يُعاد إلى مراجعة جديدة لأن الأدلة تغيّرت. من دون checker، ينتظر الحل في قائمة انتظار قالب المدقِّق. يجب أن يكون للعضو وصول إلى الحالات في هذا التطبيق، ولا يجوز أن يكون هو المسؤول الذي يرسل الحل. في قالب لا يحتوي على خطوة مدقِّق، يعيد checker الرمز 400.

الحلول بأربع أعين تحتاج عضوًا في وحدة التحكم

أرسل الحل الذي يذهب إلى مراجعة بأربع أعين بصفتك عضوًا في وحدة التحكم، لا بمفتاح API. الحل الذي يرسله مفتاح API لا يملك منشئًا مسجلًا، لذلك يعيد الاعتماد ورفض الاعتماد الرمز 403 لكل طالب، بما في ذلك المدقِّق المسمّى.

الوصول

نقاط endpoint الخاصة بالحالات تحتاج إلى مفتاح API بصلاحية وصول كاملة. المفتاح ذو الصلاحية المقيدة يتلقى 403.

ذو صلة

التفويضات

x-api-key

string

header

مطلوب

مفتاح API الخاص بتطبيقك، من Developers -> API keys في Business Console. يمتلك المفتاح الأساسي وصولاً كاملاً. يمكن تحديد نطاق المفتاح المسمى: لا شيء، أو قراءة، أو كتابة لكل مورد، ومحدوداً ببعض مسارات العمل أو بالجلسات المقبولة، وبقائمة من عناوين IP، وبتاريخ انتهاء الصلاحية. يشير 401 إلى أن المفتاح غير صحيح أو ملغى أو منتهي الصلاحية؛ ويشير 403 إلى أنه لم يتم إرسال أي مفتاح، أو أن المفتاح ليس لديه حق الوصول إلى هذا المورد أو الإجراء، أو أن الطلب جاء من عنوان خارج قائمة عناوين IP الخاصة به؛ ويشير 404 في مسار جلسة إلى أن الجلسة خارج مسارات العمل أو الحالات الخاصة بالمفتاح. يتلقى المفتاح الذي لا يمتلك حق الوصول إلى الوسائط عناوين URL للصور ومقاطع الفيديو وملفات PDF كـ null، ويتلقى المفتاح الذي لا يمتلك إذن كتابة للجلسات روابط الجلسة وtoken كـ null. راجع https://docs.didit.me/console/api-keys.

معلمات المسار

organization_id

string<uuid>

مطلوب

UUID الخاص بالمؤسسة.

application_id

string<uuid>

مطلوب

معرّف UUID للتطبيق.

case_uuid

string<uuid>

مطلوب

معرّف الحالة UUID.

مثال:

"c1a5e000-0000-4000-8000-000000000001"

الجسم

application/json

resolution

enum<string>

مطلوب

الخيارات المتاحة:

FALSE_POSITIVE,

VALID_THREAT,

INCONCLUSIVE,

REQUIREMENTS_NOT_MET,

REQUIREMENTS_SATISFIED

note

string | null

مطلوب عندما يحدد المخطط require_resolution_note.

checker

string<uuid> | null

لمخططات المراجعة الثنائية فقط. معرّف uuid للمستخدم العضو الذي يجب أن يوافق على هذا الحل (المعرّف نفسه لـ assigned_to.uuid في الحالة، أو members[].user_id في فريق المراجعة). يجب أن يمتلك العضو حق الوصول إلى الحالات في هذا التطبيق ولا يمكن أن يكون المسؤول الذي يقدم الحل. احذفه أو أرسل null لترك الحل لقائمة انتظار المدقق.

الاستجابة

محلولة، أو مُجهزة لموافقة التحقق المزدوج.

uuid

string<uuid>

case_number

string | null

title

string

status

enum<string>

الخيارات المتاحة:

OPEN,

AWAITING_USER,

RESOLVED

resolution

enum<string> | null

الخيارات المتاحة:

FALSE_POSITIVE,

VALID_THREAT,

INCONCLUSIVE,

REQUIREMENTS_NOT_MET,

REQUIREMENTS_SATISFIED

resolution_notes

string | null

priority

enum<string>

الخيارات المتاحة:

LOW,

MEDIUM,

HIGH

source

enum<string>

الخيارات المتاحة:

MANUAL,

AML_SCREENING,

TRANSACTION_RULE,

WORKFLOW_BUILDER

​تسمية المدقِّق

​الحلول بأربع أعين تحتاج عضوًا في وحدة التحكم

​الوصول

​ذو صلة

التفويضات

معلمات المسار

الجسم

الاستجابة

تسمية المدقِّق

الحلول بأربع أعين تحتاج عضوًا في وحدة التحكم

الوصول

ذو صلة