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.

Máy trạm của nhà phát triển hiển thị xác thực API và cấu hình thông tin xác thực an toàn.
01

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.

02

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ải nội dung hình ảnh lên nền tảng thông qua giao diện máy tính để bàn.
Nhà thiết kế tạo mô hình sản phẩm và dữ liệu thiết kế trong không gian làm việc sáng tạo.
03

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.

04

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ả ở đó.

Hoàn tất việc thanh toán đơn hàng và thanh toán thẻ trên máy tính xách tay.

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.

Nhóm xem xét tài liệu API trên màn hình lớn trong văn phòng hiện đại.

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ệu

Hỗ 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.