- Internal/Public portal
- Webhook portal
- API portal
- Connected app (kết nối giữa các app)
Checklist nhanh
- Đúng loại data source chưa? (portal/webhook/API/connected app)
- Token/credentials đúng và còn hiệu lực không?
- Payload/request có đủ field bắt buộc không?
- Có lỗi quyền (permissions) ở entity/field không?
- Có log/response để đối chiếu không?
2) Webhook: nhận 401/403/timeout
Nguyên nhân thường gặp
- Token sai/hết hạn
- URL endpoint sai hoặc bị chặn bởi mạng/proxy
- Timeout do payload lớn hoặc hệ thống ngoài retry không đúng
Cách xử lý
- Xác nhận token và endpoint
- Giảm payload về mức tối thiểu cần thiết
- Thiết kế retry có idempotency ở mức dữ liệu (tránh tạo trùng)
3) API: gọi được nhưng dữ liệu “không đúng”
Nguyên nhân thường gặp
- Filter/parameter sai
- Quyền xem dữ liệu bị giới hạn theo role/visibility
- Endpoint thao tác nhầm entity/field
Cách xử lý
- Thử gọi API với phạm vi nhỏ (1 record) để đối chiếu
- Kiểm tra quyền và điều kiện hiển thị record
- Kiểm tra mapping field type (date/number)
4) Connected app: không thấy data source để chọn
Nguyên nhân thường gặp
- App nguồn chưa publish data source hoặc chưa chia sẻ cho consuming app
- Chưa cấu hình đúng cơ chế chia sẻ dữ liệu
Cách xử lý
- Xem checklist tại: Liên kết dữ liệu (Data connections)
- Tra cứu cơ chế tại: Chia sẻ dữ liệu (Publish/Consume)
Chuẩn bị thông tin khi cần hỗ trợ
- Loại data source và tên data source
- Entity/field mapping
- Mã lỗi/HTTP status và response (nếu có)
- Ảnh chụp cấu hình token (che phần nhạy cảm)
- Thời điểm lỗi và request mẫu