curl -X PATCH 'https://verification.didit.me/v3/questionnaires/11111111-2222-3333-4444-555555555555/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"title": "Updated Customer Onboarding"}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.questionnaires.update(
"11111111-2222-3333-4444-555555555555",
title="Updated Customer Onboarding",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.questionnaires.update("11111111-2222-3333-4444-555555555555", {
title: "Updated Customer Onboarding",
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Questionnaires.Update(ctx, "11111111-2222-3333-4444-555555555555", didit.SimpleQuestionnaireUpdateRequest{
Title: didit.String("Updated Customer Onboarding"),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
import me.didit.types.SimpleQuestionnaireUpdateRequest;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.questionnaires().update("11111111-2222-3333-4444-555555555555", SimpleQuestionnaireUpdateRequest.builder()
.title("Updated Customer Onboarding")
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->questionnaires->update('11111111-2222-3333-4444-555555555555', [
'title' => 'Updated Customer Onboarding',
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.questionnaires.update(
"11111111-2222-3333-4444-555555555555",
title: "Updated Customer Onboarding"
)
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Questionnaires.UpdateAsync("11111111-2222-3333-4444-555555555555", new SimpleQuestionnaireUpdateRequest
{
Title = "Updated Customer Onboarding",
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"questionnaire_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"title": "<string>",
"description": "<string>",
"languages": [
"<string>"
],
"default_language": "<string>",
"is_active": true,
"is_simple_questionnaire": true,
"graph": {},
"sections": [
{}
],
"questionnaire_group_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"version": 123,
"status": "draft",
"published_at": "2023-11-07T05:31:56Z",
"is_editable": true
}{
"detail": "You do not have permission to perform this action."
}تحديث الاستبيان عبر API: تعديل نموذج KYC
عدّل استبيان KYC في Didit: أعد تسميته، واستبدل الأسئلة المرتبة، وحدّث التسميات متعددة اللغات. إدارة برمجية لنماذج الامتثال، بالدفع لكل استدعاء.
curl -X PATCH 'https://verification.didit.me/v3/questionnaires/11111111-2222-3333-4444-555555555555/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"title": "Updated Customer Onboarding"}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.questionnaires.update(
"11111111-2222-3333-4444-555555555555",
title="Updated Customer Onboarding",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.questionnaires.update("11111111-2222-3333-4444-555555555555", {
title: "Updated Customer Onboarding",
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Questionnaires.Update(ctx, "11111111-2222-3333-4444-555555555555", didit.SimpleQuestionnaireUpdateRequest{
Title: didit.String("Updated Customer Onboarding"),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
import me.didit.types.SimpleQuestionnaireUpdateRequest;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.questionnaires().update("11111111-2222-3333-4444-555555555555", SimpleQuestionnaireUpdateRequest.builder()
.title("Updated Customer Onboarding")
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->questionnaires->update('11111111-2222-3333-4444-555555555555', [
'title' => 'Updated Customer Onboarding',
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.questionnaires.update(
"11111111-2222-3333-4444-555555555555",
title: "Updated Customer Onboarding"
)
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Questionnaires.UpdateAsync("11111111-2222-3333-4444-555555555555", new SimpleQuestionnaireUpdateRequest
{
Title = "Updated Customer Onboarding",
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"questionnaire_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"title": "<string>",
"description": "<string>",
"languages": [
"<string>"
],
"default_language": "<string>",
"is_active": true,
"is_simple_questionnaire": true,
"graph": {},
"sections": [
{}
],
"questionnaire_group_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"version": 123,
"status": "draft",
"published_at": "2023-11-07T05:31:56Z",
"is_editable": true
}{
"detail": "You do not have permission to perform this action."
}PATCH للتحديثات الجزئية. لإعادة تسمية الاستبيان، أرسل title أو description فقط.
{
"title": "Updated Customer Onboarding"
}
form_elements الكاملة المطلوبة. هذا يستبدل قائمة الأسئلة السابقة. احتفظ بأي أسئلة موجودة ما زلت تريد عرضها.
{
"form_elements": [
{
"id": "occupation",
"element_type": "short_text",
"label": { "en": "What is your occupation?" },
"is_required": true
},
{
"id": "source_of_funds",
"element_type": "multiple_choice",
"label": { "en": "Source of funds" },
"options": [
{ "value": "employment", "label": { "en": "Employment" } },
{ "value": "business", "label": { "en": "Business" } }
]
}
]
}
graph وbranches وnext والقواعد الشرطية.
تتضمّن الاستجابة questionnaire_id. عند تحديث استبيان published، قد تُنشئ واجهة برمجة التطبيقات إصداراً جديداً. احفظ قيمة questionnaire_id المُرجعة واستخدمها في سير العمل، بدلاً من افتراض أن المعرّف الموجود في عنوان URL هو أحدث إصدار.التفويضات
مفتاح API الخاص بتطبيقك، من Developers -> API keys في Business Console. يمتلك المفتاح الأساسي وصولاً كاملاً. يمكن تحديد نطاق المفتاح المسمى: لا شيء، أو قراءة، أو كتابة لكل مورد، ومحدوداً ببعض مسارات العمل أو بالجلسات المقبولة، وبقائمة من عناوين IP، وبتاريخ انتهاء الصلاحية. يشير 401 إلى أن المفتاح غير صحيح أو ملغى أو منتهي الصلاحية؛ ويشير 403 إلى أنه لم يتم إرسال أي مفتاح، أو أن المفتاح ليس لديه حق الوصول إلى هذا المورد أو الإجراء، أو أن الطلب جاء من عنوان خارج قائمة عناوين IP الخاصة به؛ ويشير 404 في مسار جلسة إلى أن الجلسة خارج مسارات العمل أو الحالات الخاصة بالمفتاح. يتلقى المفتاح الذي لا يمتلك حق الوصول إلى الوسائط عناوين URL للصور ومقاطع الفيديو وملفات PDF كـ null، ويتلقى المفتاح الذي لا يمتلك إذن كتابة للجلسات روابط الجلسة وtoken كـ null. راجع https://docs.didit.me/console/api-keys.
معلمات المسار
معرف UUID لكل إصدار من الاستبيان المطلوب تحديثه.
الجسم
تحديث البيانات الوصفية للاستبيان أو استبدال قائمة form_elements الخطية الكاملة.
الاستجابة
تم تحديث الاستبيان. يمثل محتوى الاستجابة أحدث حالة للإصدار الناتج — الإصدار المحدث في مكانه، أو الإصدار المنشور المنشأ حديثاً عند إرسالك status: "published" في صف منشور (في هذه الحالة يختلف questionnaire_id وversion عما قمت بتعديله). يمثل questionnaire_id في الاستجابة معرّف UUID الخاص بالإصدار؛ استخدم questionnaire_group_id إذا كنت بحاجة إلى معرّف المجموعة الثابت.
تفاصيل الاستبيان الكاملة المرجعة من endpoint الخاصة بـ GET وPOST (إنشاء) وPATCH (تحديث).
المعرّف الفريد للاستبيان. استخدم هذا المعرّف عند الإشارة إلى الاستبيان من سير العمل أو في طلبات التحديث/الحذف اللاحقة.
هيكل المخطط مع start_node وخريطة العقد.
محتوى الاستبيان مجمّعاً في أقسام (مستمد من المخطط).
معرّف ثابت يجمع جميع إصدارات الاستبيان نفسه.
draft, published تكون القيمة True عندما يكون من الممكن تعديل الاستبيان مباشرة في مكانه (إصدارات المسودة).