Nâng cấp tích hợp khi tài liệu API đổi: tương thích trường, kiểm chữ ký và đơn cũ

Sau mở tài khoản, tài liệu thêm trường hoặc sửa ví dụ không có nghĩa được thay mã và cấu hình ngay. Phải đối chiếu bản tài liệu, cấu hình thực bật, phiên bản ứng dụng và đơn chưa xong. Đây là quản lý nâng cấp, không hứa trường phiên bản cố định, API hai bản hay thời gian tương thích của WenFuPay.

Đọc tiếp theo chủ đề

Liệt kê khác biệt và phạm vi thật trước

Giữ tham chiếu ngày hay phiên bản mới cũ; so đường, phương thức, tên và kiểu trường, bắt buộc, đơn vị tiền, enum, ký và đáp ứng. Trường mới có tham gia ký không cần xác nhận; tùy chọn không có nghĩa vô hại.

Hỏi thay đổi cho thương nhân, kênh, môi trường nào, khi bật và đơn cũ được tra, báo thế nào. Sửa ví dụ chưa chắc đổi giao thức; tên trường giữ nguyên vẫn có thể đổi nghĩa. Thay văn bản không phải kế hoạch nâng cấp.

Tách kiểm cấu trúc khỏi kết quả nghiệp vụ

OpenAPI có thể mô tả cấu trúc HTTP nhưng hợp lệ cấu trúc không chứng minh đúng chữ ký, số tiền, chủ hay giao. Thương nhân giữ bảng hợp đồng của mình mà không giả định nền tảng công bố OpenAPI.

Dùng mẫu che thông tin cho thiếu hoặc thêm trường, rỗng, kiểu số và enum lạ. Cách bản cũ nhận thông tin mới theo hợp đồng thực tế; không mặc định bỏ hết trường lạ hay từ chối mọi thông báo đúng chỉ vì có thêm trường.

Xác định ranh giới phân tích đơn cũ

Ví dụ OLD-A tạo ở cấu hình cũ nhưng xong sau bật mới. Kiểm cấu hình gốc và hợp đồng thông báo hai bên xác nhận; thời điểm nhận không chứng minh định dạng mới, không thử mọi kiểu ký đến khi một cái qua.

Giữ tham chiếu cấu hình, phạm vi hiệu lực và liên kết đơn; không đưa khóa thật vào ảnh chụp đơn hay báo cáo. Khi ngừng khóa, bộ xử lý cũ và kiểm đơn chờ cần xác nhận với kỹ thuật. Nâng cấp không xóa sự thật đã trả hay đã giao.

Kết thúc bằng kiểm lên và quay lui thực thi được

Thử đơn mới, cũ chưa rõ, thông báo, truy vấn, báo lặp, trạng thái lạ, lỗi cộng tiền và quay lui. Ghi mong đợi, thực tế, người phụ trách chứ không một ảnh HTTP thành công. Chưa phủ phải ghi chưa nghiệm thu.

Xác nhận tài liệu chính thức và lịch chuyển với WenFuPay rồi mới phát hành. Không tương thích thì hạn chế thao tác mới bị ảnh hưởng, giữ chứng cứ và quay lui theo thỏa thuận; mã quay lại vẫn phải nhận đơn đã tạo ở bản mới. Hoàn, chi hộ và khả năng khác cần xác nhận riêng, không suy đã mở chỉ vì có từ trong tài liệu.

Câu hỏi thường gặp

Thêm trường tùy chọn luôn an toàn cho bản cũ sao?

Không. Có thể đổi ký, kiểm hoặc ý nghĩa. Xác nhận phạm vi bật và hồi quy mẫu cũ mới, không chỉ nhìn từ tùy chọn.

Chọn bản chữ ký theo ngày nhận đủ không?

Không. Đơn cũ có thể báo sau chuyển, cần cấu hình gốc và ranh giới hợp đồng; chưa rõ thì hỏi kỹ thuật, không đoán.

Tài liệu tham khảo