Xây dựng với PrintKK API
Bắt đầu từ xác thực chữ ký, sau đó triển khai tải lên hình ảnh, tạo thiết kế, tạo đơn hàng và thanh toán đơn hàng bằng điểm cuối REST.
Khả năng cốt lõi API
Tập trung vào quy trình sản xuất chính từ tài sản đến thanh toán, dựa trên các nhóm điểm cuối được ghi lại.
Chữ ký và xác thực
Sử dụng thông số kỹ thuật của Chữ ký và Xác thực để bảo mật từng yêu cầu và kiểm soát quyền truy cập vào các hoạt động API của bạn.
Tải hình ảnh lên
Tải nội dung thiết kế lên thông qua điểm cuối hình ảnh và chuẩn bị tệp để tạo thiết kế tiếp theo.
Tạo thiết kế
Tạo dữ liệu thiết kế với các điểm cuối thiết kế và sắp xếp các tham số cần thiết cho đầu ra sẵn sàng sản xuất.
Tạo và thanh toán đơn hàng
Gửi trọng tải đơn hàng và hoàn tất thanh toán thông qua các điểm cuối của đơn hàng để đóng luồng giao dịch.
API Luồng tích hợp
Từ lệnh gọi được xác thực đầu tiên đến đơn đặt hàng phải trả phí, lộ trình bốn giai đoạn này phản ánh cách các API của chúng tôi được nhóm trong tài liệu: truy cập an toàn, nội dung hình ảnh, thiết kế có thể in, sau đó thanh toán và thanh toán. Hãy coi mỗi giai đoạn như một điểm kiểm tra để phần phụ trợ của bạn luôn có thể dự đoán được và dễ gỡ lỗi.
Cấu hình chữ ký và xác thực
Đọc các chương Chữ ký và Xác thực, cấp hoặc nhập thông tin xác thực mà môi trường của bạn cần và triển khai ký chính xác như được chỉ định. Gửi một số yêu cầu kiểm tra có rủi ro thấp và xác nhận rằng bạn nhận được phản hồi thành công trước khi chạm vào nội dung tải lên--khi xác thực ổn định, các lỗi sau này hầu như luôn trỏ đến hình dạng tải trọng thay vì 401 bí ẩn.
Tải lên hình ảnh sản phẩm của bạn cần
Sử dụng điểm cuối hình ảnh để tải lên logo, tác phẩm nghệ thuật hoặc các tệp khác mà quá trình tích hợp của bạn yêu cầu. Lưu trữ từng mã định danh được trả về trong phản hồi API để bạn có thể chuyển những giá trị đó vào các yêu cầu thiết kế tiếp theo có hình dạng giống như các ví dụ về yêu cầu.
Tạo và duy trì hồ sơ thiết kế
Gọi các điểm cuối thiết kế để tạo bản ghi thiết kế kết hợp các sản phẩm, vị trí và tham chiếu hình ảnh từ bước trước. Giữ các mã nhận dạng thiết kế được trả về trong hệ thống của bạn để tải trọng đơn hàng có thể tham chiếu chúng như được mô tả trong phần Đơn hàng của tài liệu.
Gửi đơn hàng và hoàn tất thanh toán
Gửi đơn đặt hàng thông qua điểm cuối của đơn hàng bằng cách sử dụng mã nhận dạng thiết kế mà bạn đã lưu trữ. Hoàn tất thanh toán bằng cách làm theo các bước được ghi lại cho các điểm cuối liên quan đến thanh toán. Phản hồi, mã trạng thái và nội dung lỗi trong tài liệu là có căn cứ--không dựa vào hành vi không được mô tả ở đó.
Ngoài con đường tích hợp cốt lõi
Tài liệu API chính thức cũng nhóm Sản phẩm, Chung, Câu hỏi thường gặp và Nhật ký thay đổi cùng với Xác thực, Hình ảnh, Thiết kế và Đơn hàng. Sử dụng các phần này khi bạn cần dữ liệu danh mục, tiện ích dùng chung hoặc lịch sử phát hành mà luồng cốt lõi không bao gồm chính nó.
-
sản phẩm
Điểm cuối Sản phẩm mô tả cách truy vấn các mục trong danh mục, mẫu mã và tùy chọn phù hợp với thiết kế và đơn đặt hàng. Hãy tham khảo ý kiến của họ khi bạn phải giải quyết ID hoặc thuộc tính sản phẩm trước khi tạo trọng tải.
-
chung
Phần Chung bao gồm các tiện ích và các yêu cầu xuyên suốt nằm bên cạnh các lệnh gọi hình ảnh, thiết kế và đặt hàng. Kiểm tra tài liệu tham khảo khi bạn cần ghi lại các hoạt động trợ giúp ở đó.
-
Câu hỏi thường gặp và nhật ký thay đổi
Đọc Câu hỏi thường gặp về các câu hỏi tích hợp phổ biến và sử dụng Nhật ký thay đổi để theo dõi các cập nhật, bổ sung API và mọi thay đổi đáng chú ý theo thời gian.
Các trường hợp sử dụng API phổ biến
Các mẫu triển khai điển hình được xây dựng dựa trên khả năng hình ảnh, thiết kế và đặt hàng.
Đường ống thiết kế tự động
Tải hình ảnh lên hàng loạt và tạo thiết kế theo chương trình để tăng tốc quá trình sản xuất nội dung.
Dịch vụ gửi đơn hàng
Xây dựng dịch vụ phụ trợ chuyển đổi dữ liệu thanh toán thành các yêu cầu đặt hàng được tiêu chuẩn hóa.
Quy trình hoàn tất thanh toán
Kết nối các điểm cuối tạo đơn hàng và thanh toán thành một chuỗi giao dịch được kiểm soát với khả năng xử lý trạng thái rõ ràng.
Tài nguyên dành cho nhóm
Sử dụng tài liệu và các kênh hỗ trợ để đẩy nhanh quá trình phát triển và triển khai.
Tài liệu dành cho nhà phát triển
Xem lại các nhóm điểm cuối, chi tiết xác thực và ví dụ về tải trọng cho các hoạt động hình ảnh, thiết kế và đặt hàng.
Mở Tài liệuHỗ trợ kỹ thuật
Hãy liên hệ với nhóm PrintKK nếu có câu hỏi về triển khai và khắc phục sự cố tích hợp.
API Câu hỏi thường gặp
Đầu tiên chúng ta nên thực hiện điều gì?
Bắt đầu với Chữ ký và Xác thực để mọi hình ảnh, thiết kế và yêu cầu đặt hàng tiếp theo đều có thể xác minh và bảo mật.
Những hoạt động cốt lõi nào được hỗ trợ?
Các hoạt động được ghi chép cốt lõi là tải lên hình ảnh, tạo thiết kế, tạo đơn hàng và thanh toán đơn hàng.
Chúng ta nên cấu trúc chuỗi cuộc gọi như thế nào?
Sử dụng luồng tuyến tính: xác thực yêu cầu, tải hình ảnh lên, tạo thiết kế, tạo đơn hàng, sau đó hoàn tất thanh toán.
Chúng tôi có thể tìm thấy chi tiết yêu cầu ở đâu?
Xem tài liệu API để biết thông số điểm cuối, ví dụ về yêu cầu và ghi chú triển khai theo từng phần cụ thể.
Bắt đầu tích hợp ngay hôm nay
Mở tài liệu API để xem quy tắc chữ ký, tham số điểm cuối và ví dụ yêu cầu cho từng khả năng.