Jobs และผลรายแถว
202 Accepted ยืนยันเพียงว่าระบบรับ request เข้าคิวแล้ว ให้บันทึก job_id และเรียก
GET /integrations/activity-imports/{job_id} จนสถานะเป็น terminal
Terminal status ที่ต้องรองรับ ได้แก่ completed, completed_with_skips,
completed_with_errors และ failed หลังจากนั้นเรียก
GET /integrations/activity-imports/{job_id}/items จนครบทุกหน้าตาม has_more และ next_cursor
Counter reconciliation
ตรวจว่า received_rows, processed_rows, created_rows, validated_rows, skipped_rows,
pending_review_rows และ failed_rows สอดคล้องกับ item จริง ห้ามใช้เพียง job status เป็น PASS
| Row status | ความหมาย |
|---|---|
would_create | dry-run ผ่าน แต่ยังไม่สร้างข้อมูล |
created | persist สร้าง business row แล้ว |
skipped_duplicate | business identity เดิม จึงไม่สร้างซ้ำ |
failed | แถวไม่ผ่าน ต้องเก็บ code/trace ที่ redact แล้ว |
ตั้ง polling interval แบบมีเพดานและ timeout ห้าม poll ถี่ไม่จำกัด หากหมดเวลาควรคง durable job ID เพื่อ resume ภายหลัง ไม่สร้าง submission ใหม่