main class="main" id="main" role="main">

การเชื่อมต่อ API

สั่งงานคำขอลบข้อมูล (GDPR) ผ่านโปรแกรม ตรวจสถานะการส่ง และรับเหตุการณ์ผ่าน Webhook — ปลอดภัยและใช้งานง่าย

Base URL: https://supacheap.eu • JSON ผ่าน HTTPS

เริ่มต้นอย่างรวดเร็ว

  1. รับ API key จากแดชบอร์ด
  2. ทดสอบด้วย dry run เพื่อยืนยันสิทธิ์และโครงสร้างข้อมูล
  3. ส่งคำขอจริง (หรือคิวไว้ผ่านผู้ให้บริการอีเมลตามการตั้งค่า)

การยืนยันตัวตน: ส่ง api_key ใน JSON body อัตราจำกัด: 10 ครั้ง/นาที ต่อ key

เอ็นด์พอยต์: ส่งคำขอลบข้อมูล

POST /api/user/remove

{
  "api_key": "YOUR_API_KEY",
  "broker": "CoreLogic",
  "dry_run": true
}

ใช้ dry_run=true เพื่อทดสอบโดยไม่ส่งอีเมล หากผู้ให้บริการต้องกรอกแบบฟอร์ม ระบบจะตอบกลับด้วย "type":"form" และ removal_form_url.

ตัวอย่าง (curl)

curl -sS -L https://supacheap.eu/api/user/remove \
  -H 'Content-Type: application/json' \
  -d '{"api_key":"<KEY>","broker":"CoreLogic","dry_run":true}'
curl -sS -L https://supacheap.eu/api/user/remove \
  -H 'Content-Type: application/json' \
  -d '{"api_key":"<KEY>","broker":"CoreLogic"}'

คำตอบ (dry run)

{
  "ok": true,
  "dry_run": true,
  "broker": "CoreLogic",
  "signature": "user_remove providers v1"
}

คำตอบ (ส่งผ่าน Mailjet)

{
  "ok": true,
  "sent_via": "mailjet",
  "to": "privacy@corelogic.com",
  "provider_status_code": 200,
  "provider_message_id": "288230407927261671",
  "broker": "CoreLogic"
}

คำตอบ (คิวส่งแบบ fallback)

{
  "ok": true,
  "queued": true,
  "queue_id": "7844f711-a12c-40c5-a215-4b1aa55ea57e",
  "to": "privacy@corelogic.com",
  "broker": "CoreLogic"
}

คำตอบ (ต้องกรอกแบบฟอร์ม)

{
  "ok": true,
  "type": "form",
  "info": "Dieser Broker verlangt ein Online-Formular.",
  "removal_form_url": "https://broker.example.com/remove"
}

ข้อผิดพลาด

{
  "ok": false,
  "error": "Broker nicht erlaubt"
}

ตัวอย่างอื่น ๆ: Ungültiger Account, Account inaktiv, Account abgelaufen, Broker nicht gefunden

ฟิลด์ข้อมูลส่วนบุคคล (ไม่บังคับ)

เพื่อช่วยการยืนยันตัวตนกับบางผู้ให้บริการ คุณสามารถส่งฟิลด์เพิ่มเติมได้ เนื้อหาอีเมลจะไม่ถูกเก็บถาวร

{
  "api_key": "<KEY>",
  "broker": "CoreLogic",
  "personal_data": {
    "full_name": "Jane Doe",
    "address": "Street 1, 12345 City, DE",
    "phone": "+49 170 000000",
    "country": "DE",
    "birth_date": "1990-01-01"
  }
}

ตรวจสุขภาพระบบ

GET /api/health/email

{
  "env_key_present": true,
  "env_secret_present": true,
  "mailjet_available": true,
  "sender_present": true,
  "use_mailjet": true
}

Webhook (เหตุการณ์อีเมล)

ตั้งค่าให้ผู้ให้บริการส่ง POST มาที่: /api/webhooks/mailjet?token=<WEBHOOK_TOKEN>

[
  {
    "event": "sent",
    "email": "privacy@corelogic.com",
    "MessageID": 999,
    "MessageUUID": "uuid-999",
    "Subject": "Deletion request"
  }
]

กำหนดโทเคนในเซิร์ฟเวอร์ผ่าน MAILJET_WEBHOOK_TOKEN ระบบจะบันทึกเหตุการณ์ที่ตาราง mail_events เพื่อการตรวจสอบการส่ง

ความปลอดภัย