حذف بيانات مستخدم

تمحو البيانات التي تحتفظ بها Gurdx عن أحد مستخدميك النهائيين لتتمكن من تلبية طلبات الحذف بموجب قوانين الخصوصية.

نظرة عامة#

حين يطلب أحد عملائك أن يُنسى، يزيل account/users/delete ما خزّنته Gurdx عنه. تحدد الشخص بالمعامل value: بريد إلكتروني أو رقم جوال أو معرّف المستخدم الذي مرّرته كـuserID في الاستدعاءات الأخرى. الاستجابة عدد السجلات المحذوفة لكل فئة: transaction_data وips وprofanity_data وemails وphone_numbers وibans. وهي دالة DELETE.

متى تستخدمها#

• حين يمارس مستخدم حقه في المحو بموجب GDPR أو لائحة مماثلة.
• حين تغلق حسابًا وتريد إزالة سجل التحليل المرتبط به.
• حين تحتاج إلى تنظيف بعد اختبار استخدم معرّفات حقيقية.

آلية العمل#

تبحث Gurdx عن القيمة في سجل الطلبات والبيانات المشتقة لحسابك، وتحذف المطابق، وتبلغ بعدد السجلات المحذوفة من كل نوع. الفئة التي قيمتها 0 لم يكن فيها شيء لهذا المستخدم. الحذف نهائي ولا يمكن التراجع عنه، فتأكد من الطلب أولًا.

Warning: يزيل الحذف سجلات Gurdx فقط. قاعدة بياناتك وسجلاتك ونسخك الاحتياطية وأي نسخ احتفظت بها من استجابات الـ API مسؤوليتك أنت.

ولأن أحداث التحليل تستخدم المعرّف الذي زوّدتنا به، فاستخدم نمط المعرّف نفسه في استدعاء الحذف. وإن استخدمت الخيار userID باتساق فتمرير هذا المعرّف يزيل كل طلب وُسم به.

ملاحظات#

• هذه الدالة مجانية: لا تستهلك حصتك الشهرية ولا تُفوتر. وهي مشمولة في كل الباقات.
• يوجد حد يومي لعمليات الحذف لكل حساب. عند بلوغه يُرجع الخطأ 126 (too_many_deletions)؛ انتظر اليوم التالي وأعد المحاولة.
• المدخل الفارغ أو غير الصحيح يُرجع الخطأ 125 (invalid_user_value)، ونوع المعرّف غير المعروف يُرجع 124 (invalid_user_type)، دائمًا مع HTTP 200.
• لا تطلق أحداثًا ولا تتأثر بالقواعد المخصصة أو القوائم السوداء، علمًا أن مدخلات القوائم السوداء التي أنشأتها بنفسك تُدار منفصلة في لوحة التحكم.
• وضع الاختبار يُرجع عددًا وهميًا معقولًا ولا يحذف شيئًا.

الطلب#

• صادِق بمعامل key أو بترويسة Authorization: Bearer.
• مجانية — لا تُحتسب من حصتك.
• متاحة في: تجربة مجانية القياسية المميّزة الدفع حسب الاستخدام

المعاملات#

تقبل كل خدمة أيضاً format, lang, mode, userID. راجع الخيارات.

أمثلة برمجية#

curl -X DELETE "https://gurdx.cretip.com/api/account/users/delete" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "value=user@example.com"

<?php

$ch = curl_init('https://gurdx.cretip.com/api/account/users/delete');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
    CURLOPT_POSTFIELDS => http_build_query(['value' => 'user@example.com']),
]);
$result = json_decode(curl_exec($ch), true);
print_r($result);

const res = await fetch('https://gurdx.cretip.com/api/account/users/delete', {
  method: 'DELETE',
  headers: { Authorization: 'Bearer YOUR_API_KEY' },
  body: new URLSearchParams({ value: 'user@example.com' }),
});
console.log(await res.json());

import requests

res = requests.delete(
    "https://gurdx.cretip.com/api/account/users/delete",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    data={"value": "user@example.com"},
)
print(res.json())

الاستجابة#

نجاح#

{
    "data": {
        "transaction_data": 25,
        "ips": 4,
        "profanity_data": 3,
        "emails": 1,
        "phone_numbers": 1,
        "ibans": 10
    },
    "status": "success"
}

خطأ#

تُسلَّم الأخطاء بحالة HTTP 200 — افحص دائماً حقل status.

{
    "status": "error",
    "code": 101,
    "type": "invalid_key",
    "description": "The API Key is missing or invalid."
}

حقول الاستجابة#