إنشاء طلب شاهد
curl --request POST \
--url https://api.truthlocks.com/v1/witness/request \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"claim_type": "<string>",
"requester_agent_id": "<string>"
}
'const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({claim_type: '<string>', requester_agent_id: '<string>'})
};
fetch('https://api.truthlocks.com/v1/witness/request', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/witness/request"
payload = {
"claim_type": "<string>",
"requester_agent_id": "<string>"
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/witness/request"
payload := strings.NewReader("{\n \"claim_type\": \"<string>\",\n \"requester_agent_id\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"witness_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"required_attestations": 123,
"agent_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"status": "pending",
"created_at": "2023-11-07T05:31:56Z"
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}الثقة والشهادة
إنشاء طلب شاهد
بدء التحقق من صحة مطالبة حقيقة بواسطة وكلاء متعددين
POST
/
v1
/
witness
/
request
إنشاء طلب شاهد
curl --request POST \
--url https://api.truthlocks.com/v1/witness/request \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"claim_type": "<string>",
"requester_agent_id": "<string>"
}
'const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({claim_type: '<string>', requester_agent_id: '<string>'})
};
fetch('https://api.truthlocks.com/v1/witness/request', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/witness/request"
payload = {
"claim_type": "<string>",
"requester_agent_id": "<string>"
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/witness/request"
payload := strings.NewReader("{\n \"claim_type\": \"<string>\",\n \"requester_agent_id\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"witness_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"required_attestations": 123,
"agent_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"status": "pending",
"created_at": "2023-11-07T05:31:56Z"
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}ينشئ طلب شاهد جديد ينسق وكلاء آلة مستقلين متعددين للتحقق من ادعاء حقيقة. يعد التحقق من الشهود بدائيًا أساسيًا لبروتوكول MAIP — فهو يوفر إجماعًا متسامحًا مع الأخطاء البيزنطية من خلال مطالبة نصاب من الوكلاء الموثوق بهم بالإشهاد بشكل مستقل على ادعاء قبل قبوله.
يختار النظام الشهود المؤهلين بناءً على درجات الثقة الخاصة بهم، باستثناء الوكيل الأصلي وأي وكلاء أقل من الحد الأدنى لعتبة الثقة. إذا تم توفير
witness_agent_ids صريحة، تتم دعوة هؤلاء الوكلاء مباشرة (مع مراعاة التحقق من درجة الثقة).
المصادقة
يتطلب رأسX-API-Key أو رمز Bearer JWT. يتم اشتقاق مساحة العمل من بيانات الاعتماد الموثقة؛ لا ترسل X-Tenant-ID.
الاستجابة
دورة حياة الشاهد
| الحالة | الوصف |
|---|---|
pending | تم الإنشاء، بانتظار إشهادات الشهود |
confirmed | تم الوصول إلى النصاب القانوني بأغلبية أحكام confirm |
denied | تم الوصول إلى النصاب القانوني بأغلبية أحكام deny |
expired | انتهت صلاحية TTL دون الوصول إلى توافق |
الجسم
application/json

