Để AI thực hiện việc gọi API — trong khi bạn kiểm tra hình dạng
Đây là sự phân chia công việc thực tế. AI thực sự giỏi viết code gọi : nó biết các thư viện, cú pháp header, cách xử lý lỗi. Hãy để nó làm. Bạn không cần tự tay viết phần "ống dẫn" này.
Nhưng bạn sở hữu một thứ mà AI không giỏi: biết liệu hình dạng dữ liệu có thực sự đúng hay không. Một quy trình làm việc tốt:
- Đưa cho AI tài liệu thật. Dán request và response mẫu từ tài liệu vào của bạn. Việc AI đoán hình dạng của một API từ trí nhớ là một nguồn lỗi hàng đầu — nó sẽ bịa ra những khóa nghe có vẻ hợp lý nhưng không tồn tại. Các ví dụ thực tế neo nó vào thực tế.
- Yêu cầu nó cho bạn xem phản hồi thô trước. "Trước khi phân tích, hãy log ra thực tế mà API trả về." Rồi liếc qua nó so với những gì code kỳ vọng. Khóa mà nó đọc (
response.current.temp) có thực sự tồn tại trong phản hồi không? Một nửa số lỗi API là một tên khóa không khớp. - Kiểm tra hợp lý các kiểu dữ liệu. Đó là một con số hay một chuỗi? Một trường lẽ ra phải luôn có mặt đôi khi lại là
null? Bây giờ bạn đã biết đọc JSON — hãy dùng nó. - Xử lý con đường không suôn sẻ. Hỏi: "Điều gì xảy ra nếu lượt gọi này thất bại, hết thời gian chờ, hoặc chạm giới hạn tần suất?" Nếu câu trả lời là "ứng dụng bị crash," đó là một lỗi, không phải một tính năng.
Bạn không cần viết request. Bạn cần đọc response và hỏi "đây có phải là hình dạng tôi mong đợi không?" Thói quen đơn lẻ đó — kiểm tra dữ liệu so với hợp đồng — bắt được phần lớn các lỗi tích hợp trước khi người dùng của bạn nhìn thấy chúng.