Nhóm lệnh listen
nhom lenh listenTham chiếu 1 lệnh của nhóm listen trong CLI dtp: cú pháp, cờ, quyền cần có, ví dụ và mã thoát. tham chieu 1 lenh cua nhom listen trong cli dtp: cu phap, co, quyen can co, vi du va ma thoat.Các cờ toàn cục (xem tổng quan) áp dụng cho mọi lệnh dưới đây và không được lặp lại ở từng lệnh.
listen
Phần tiêu đề “listen”dtp listen --forward-to <url> [--events <pattern>] [--live] [--allow-remote-forward] [--api-url <url>]Lắng nghe sự kiện thời gian thực và chuyển tiếp (forward) dạng Standard Webhooks tới máy chủ cục bộ
- Thay đổi dữ liệu: Không
- Hỗ trợ
--dry-run: Không - Scope cần có:
transactions:read - Có từ phiên bản:
0.1.0
| Cờ | Viết tắt | Kiểu | Mặc định | Bắt buộc | Lặp lại | Biến môi trường | Mô tả |
|---|---|---|---|---|---|---|---|
--forward-to <URL> | — | string | — | Có | Không | — | Địa chỉ máy chủ cục bộ nhận webhook (ví dụ: localhost:3000/webhook) |
--events <PATTERN> | — | string | * | Không | Không | — | Mẫu sự kiện cần lọc, phân cách bằng dấu phẩy (ví dụ: 'transaction.,reconcile.') |
--live | — | bool | — | Không | Không | — | Lắng nghe sự kiện thật (yêu cầu scope webhooks:write, ghi nhật ký kiểm toán, che số tài khoản) |
--allow-remote-forward | — | bool | — | Không | Không | — | Cho phép --forward-to trỏ ra ngoài máy cục bộ |
--api-url <URL> | — | string | — | Không | Không | — | Địa chỉ API |
Ví dụ
Phần tiêu đề “Ví dụ”Nhận sự kiện giao dịch sandbox về máy và chuyển tiếp tới ứng dụng đang chạy. (chế độ đầu ra: ndjson)
dtp listen --forward-to localhost:3000/hook --events "transaction.*"Mã thoát
Phần tiêu đề “Mã thoát”| Mã | Tên | Ý nghĩa | Thử lại? |
|---|---|---|---|
| 0 | ok | Thành công. | Không |
| 2 | invalid_args | Tham số hoặc dữ liệu đầu vào không hợp lệ. | Không |
| 3 | auth_error | Chưa đăng nhập, khoá không hợp lệ hoặc thiếu quyền. | Không |
| 4 | not_found | Không tìm thấy đối tượng. | Không |
| 5 | conflict | Xung đột với trạng thái hiện tại. | Không |
| 6 | rate_limited | Bị giới hạn tốc độ. | Có |
| 7 | network_error | Lỗi mạng hoặc máy chủ (5xx). | Có |
| 130 | interrupted | Bị ngắt bằng Ctrl+C. | Không |
API tương ứng
Phần tiêu đề “API tương ứng”GET /v1/me· operationIdgetMe· nhóm Danh tính · Xem trong ScalarPOST /v1/realtime/tickets· operationIdcreateRealtimeTicket· nhóm Thời gian thực · Xem trong ScalarGET /v1/realtime/ws· operationIdopenRealtimeSocket· nhóm Thời gian thực · Xem trong Scalar