API Nguồn đẩy tùy chỉnh (Custom Push Source)

​

Trước khi bắt đầu

• quyền quản lý tích hợp và khóa truy cập trong Living Security
• một bên gửi phía máy chủ có khả năng thực hiện các yêu cầu HTTPS POST
• khu vực Living Security của tổ chức quý vị
• một tên nguồn ổn định và ít nhất một tên luồng

​

1. Đăng ký nguồn và các luồng

​

2. Tạo khóa push-ingest

​

3. Chọn điểm cuối theo khu vực

​

Nội dung yêu cầu

​

4. Gửi một lô JSON

curl --request POST \
  'https://api.us-east-1.livingsecurity.ai/api/v1/push-ingest/custom-phishing-sim/events' \
  --header 'Authorization: Bearer <access-key>' \
  --header 'Content-Type: application/json' \
  --data '[
    {
      "email": "person@example.com",
      "event_at": "2026-09-21T14:30:00Z",
      "action": "reported"
    }
  ]'

curl --request POST \
  'https://api.us-east-1.livingsecurity.ai/api/v1/push-ingest/custom-phishing-sim/events' \
  --header 'Authorization: Bearer <access-key>' \
  --header 'Content-Type: text/csv' \
  --data-binary '@events.csv'

{
  "runId": "01a0c45f-ae40-7e5f-8a9b-0c1d2e3f4a5b",
  "recordsAccepted": 1,
  "integrationKey": "custom-phishing-sim",
  "streamName": "events"
}

{
  "statusCode": 400,
  "timestamp": "2026-09-22T14:30:00.000Z",
  "path": "/api/v1/push-ingest/custom-phishing-sim/events",
  "message": "Request body is not valid JSON. Send a JSON array of objects, or set Content-Type: text/csv to push a CSV.",
  "error": "Bad Request"
}

​

Gửi CSV thay thế

​

Giới hạn yêu cầu và thử lại

​

Xác minh luồng dữ liệu

​

Danh sách kiểm tra khắc phục sự cố

• Sao chép điểm cuối từ đúng nguồn và thay thế phần giữ chỗ của luồng.
• Gửi khóa truy cập dưới dạng Authorization: Bearer …; x-api-key không được chấp nhận.
• Xác nhận nội dung là một mảng JSON cấp cao nhất, không phải một đối tượng đơn lẻ hoặc một lớp bao bọc quanh các bản ghi.
• Xác nhận chính tả của nguồn và luồng, bao gồm dấu gạch nối, dấu gạch dưới và chữ hoa chữ thường.
• Xem lại Push History trước khi gửi lại một lô có phản hồi bị mất.
• Khi liên hệ Bộ phận Hỗ trợ của Living Security, hãy cung cấp tổ chức, nguồn, luồng, thời điểm gửi yêu cầu, runId nếu có và trạng thái phản hồi. Không bao gồm khóa truy cập hoặc payload sự kiện.

​

Nội dung liên quan