UV cloud printing open platform is developed by Refinecolor ® The SAAS software system independently designed and developed by the team is professional and reliable
UV cloud printing open platform is based on Internet cloud services, cloud storage and Refinecolor ® UV printer hardware, utilizing internet technologies such as instant messaging, data exchange, and open interconnection, provides printing services that combine internet and UV printer resources, allowing developers' third-party platforms to communicate in real-time with UV printers through network requests, achieving remote calling and printing functions
UV cloud printing open platform consists of open platform, Refinecolor ® Composed of network printing interface, printing terminal software, and printing driver software, the interface is formed through integration and opened to the public, allowing developers to easily connect with Refinecolor Cloud ® Printing, quickly realizing various customized printing needs and services
If the device encounters an unsolvable problem during debugging, you can contact the person in charge of cloud printing to troubleshoot the problem and find a solution. Contact information is as follows:
Phone: 137-5177-4454 [WeChat account]
Email: info@ColorPark.cn
Call the printing interface provided by the platform, and the printer cooperates with cloud services and client applications to achieve task scheduling and queue printing.
At the same time, it can provide real-time access to task status, device status, and remote cleaning and maintenance of equipment.
Applicable scenario: Various web applications, mini programs, and apps with networking needs.
1、Printer ID
Each printer is assigned a unique printer ID, which can be viewed and copied in the "Device List".2、Printer Key
The printer key is used to ensure data security in enterprise applications, and each application has an independent access key. To ensure data security, the printer key must not be leaked.3、Generate Signature
Generating a signature is the process of generating an encrypted string by encrypting the printer ID, pritner key, random number, and create time, which is used to verify the authenticity of the other party's source data during transmission. Please refer to the section on 《Generating Signatures》 for the method of generating signatures.4、Callback API
The callback interface is a way for Ruifeng Color open platform to notify third-party platforms, such as the status of printers and the progress of printing tasks. Please refer to the sections of Printer Status Callback and Print Task Callback for details.5、Printing Terminal Software
The printing terminal software is used to receive printing messages, receive printing pictures, process printing pictures and send them to the printer. It connects the intermediate software between the open platform and the printer. The computer connected to each printer must install a printing terminal software and bind the corresponding printer ID.
Choose ColorPark UV cloud printing - no R&D investment, no server investment, no cumbersome operations
In a real usage environment, the following steps are required to truly implement the call of the third-party platform and Refinecolor network printing interface, and complete the entire set of custom UV printing services.
1. Purchase UV printers from Refinecolor
2. Install printer driver software
3. Install printing terminal software
4. Bind the assigned printer ID on the printing terminal software
5. Implement docking with network printing interfaces
The generated signature is a key parameter used to verify the legitimacy of interface requests and has the following functions:
1. Preventing requests from being tampered with: The generation of signatures requires the use of keys such as secret. Only those who know these keys can generate the correct signature, which can prevent requests from being tampered with or maliciously attacked.
2. Prevent replay attacks: The signature includes parameters such as a timestamp, and each request's signature is different. This can prevent the same request from being sent repeatedly and prevent replay attacks.
3. Confirm Request Source: The signature contains parameters such as the developer's num, which can be used to confirm the source of the request and prevent illegal requests.
Therefore, in the interface development of open platform, signature verification is a very important step. The developer needs to verify the correctness of the signature after receiving the request according to the signature algorithm provided by Refinecolor open platform to ensure the legitimacy of the interface request. Only requests that pass signature verification can continue with subsequent business processing.
1. The fields participating in the signature include printer ID, printer key, once (random string, randomly generated by the developer), and time (create time, generated by the developer).
2. After all the parameters to be signed are sorted by the ASCII code of the field name from small to large (lexicographical order order), they are concatenated into the string string1 using the format of URL key value pairs (that is, key1=value1&key2=value2...). It should be noted that all parameter names are lowercase characters.
Pay special attention to the following important rules:
1）. The parameter names are sorted from small to large (lexicographical order) in ASCII code.
2）. If the value of the parameter is empty, it does not participate in the signature.
3）. Parameter names are case sensitive.
3. Next, perform MD5 encryption on string1
ColorPark - We have an excellent and innovative software and hardware research and development design team.
The cloud printing open platform communication protocol is a stateless, lightweight RPC communication protocol based on HTTP
For user experience considerations and to balance compatibility and security risks, the interface gateway side supports HTTPS. For inbound users, please use the HTTPS protocol.
This agreement only defines the format and method of data interaction, and does not focus on the transmission method of data, authentication method, or interface version control.
The open platform RPC call is mainly used for client applications to actively obtain the open platform server side data information. It is implemented by sending HTTP POST or GET request objects to the open platform API server through the client application, and the server returns the response object.
Unless otherwise specified, all parameter values of the interface are encoded in UTF-8
Printers with network capabilities can be upgraded to connect with cloud printing capabilities, and printing products are not limited.
| Model | Picture | Parameter |
|---|---|---|
| PC |  |
Suit：UV Nozzle：Single Nozzle Height：Fixed Color：CMYK / CMYK+W Size：60*47*42.5 cm Weight：33kg |
| TS1/2 |  |
Suit：UV/ T-shirt / Gloss oil Nozzle：Single Nozzle / Double Nozzle Height：5CM Color：CMYK / CMYKW / CMYKWGloss oil Size：80.5*76.5*51 cm Weight：60kg |
| ZZ1E/2E |  |
Suit：UV / T-shirt / Bake / Gloss oil Nozzle：Single Nozzle / Double Nozzle Height：20CM Color：CMYK /CMYKW / CMYKWGloss oil Size：80*76.5*63.5cm Weight：72kg |
Create a print task, which is mainly used for the third-party platform to send a print picture task to the open platform through the interface method. After receiving the print task, the open platform will automatically send it to the print terminal software of the corresponding device number. Printing tasks can be distributed offline, and once the printing terminal is online, it can receive all offline distribution tasks
| API Address | http://www.colorpark.cn/api/Printer/mulPrint |
| Request Method | POST |
| Parameter Name | Parameter value（Example） | Must | Parameter Description |
|---|---|---|---|
| printer_id | 500001 | Yes | The unique ID assigned to the printer, with each printer assigned a different ID |
| once | 8305 | Yes | Random number used when encrypting signature generation |
| time | 1646790335 | Yes | The timestamp used when encrypting signature generation |
| sign | 9ce3ce7a3fccaf3d7715bd7e9bb1dc1c | Yes | The generated signature, please refer to the section on generating signatures in the Bottom Level Method【Foundation Support】 |
| order_id | 164679033555822 | Yes | The order ID of a third-party platform, supports a maximum of 32 characters |
| name | Product A | Yes | The product name of third-party platform, supports up to 32 characters |
| file | https://img.colorpark.cn/api/render/36531651306594235.png | Yes | The website address of the image that generated by a third-party platform, with a maximum support of 255 characters. |
| width | 185 | No | The width of image, in millimeters |
| height | 140 | No | The height of image, in millimeters |
| left | 0 | No | The left margin of the starting point, in millimeters |
| top | 0 | No | The top margin of the starting point, in millimeters |
| callback | http://www.abc.com/api/callback | Yes | The callback address used by third-party systems to receive printing notifications, such as start printing notifications, complete printing notifications, cancel printing notifications, and print fault notifications |
| Parameter Name | Parameter value(Example) | Parameter Description | |
|---|---|---|---|
| code | 0 | Return the result status code, 0 on success and 1 on failure | |
| msg | Submitted Successfully | Return result description, such as: Successfully Submitted | |
| data | taskid | 20000196 | Unique ID for printing tasks |
| order_id | 164679033555822 | The order ID of a third-party platform, supports a maximum of 32 characters | |
| status | 0 | Print Status，0:Waiting 1:Printing 2:Completed 3:Cancell 4:Failure | |
The query printing service is mainly used to query the main information of the printed tasks that have been dispatched, and can be called in the places where the printing task information needs to be displayed on third-party platforms.
| API Address | http://www.colorpark.cn/api/Printer/getTask |
| Request Method | POST |
| Parameter Name | Parameter value（Example） | Must | Parameter Description |
|---|---|---|---|
| printer_id | 500001 | Yes | The unique ID assigned to the printer, with each printer assigned a different ID |
| once | 8305 | Yes | Random number used when encrypting signature generation |
| time | 1646790335 | Yes | The timestamp used when encrypting signature generation |
| sign | 9ce3ce7a3fccaf3d7715bd7e9bb1dc1c | Yes | The generated signature, please refer to the section on generating signatures in the Bottom Level Method【Foundation Support】 |
| taskid | 20000196 | Yes | Unique ID for printing tasks |
| Parameter Name | Parameter value（Example） | Parameter Description | |
|---|---|---|---|
| code | 0 | Return the result status code, 0 on success and 1 on failure | |
| msg | Submitted Successfully | Return result description, such as: Successfully Submitted | |
| data | taskid | 20000196 | Unique ID for printing tasks |
| printer_id | 500001 | Printer Unique ID | |
| order_id | 164679033555822 | The order ID of a third-party platform, supports a maximum of 32 characters | |
| template_id | 1 | Print Template ID | |
| name | Product A | Trade Name | |
| file | https://img.colorpark.cn/api/render/80301001651287933588.png | URL address for printing images | |
| status | 0 | Print Status，0:Waiting 1:Printing 2:Completed 3:Cancell 4:Failure | |
| callback | 0 | The callback address used by third-party systems to receive printing notifications, such as start printing notifications, complete printing notifications, cancel printing notifications, and print fault notifications | |
| create_time | 0 | Print task creation time | |
| start_time | 0 | Start printing time | |
| finish_time | 0 | Complete printing time | |
If you do not need to print the print task after distributing the print task, for example, if the order has been refunded, you can find the call to cancel the print task on the third-party platform to the open platform. If the print task is in the process of printing or has been printed, the print task cannot be cancelled successfully.
| API Address | http://www.colorpark.cn/api/Printer/cancelPrint |
| Request Method | POST |
| Parameter Name | Parameter value（Example） | Must | Parameter Description |
|---|---|---|---|
| printer_id | 500001 | Yes | The unique ID assigned to the printer, with each printer assigned a different ID |
| once | 8305 | Yes | Random number used when encrypting signature generation |
| time | 1646790335 | Yes | The timestamp used when encrypting signature generation |
| sign | 9ce3ce7a3fccaf3d7715bd7e9bb1dc1c | Yes | The generated signature, please refer to the section on generating signatures in the Bottom Level Method【Foundation Support】 |
| taskid | 20000196 | Yes | Unique ID for printing tasks |
| Parameter Name | Parameter value(Example) | Parameter Description | |
|---|---|---|---|
| code | 0 | Return the result status code, 0 on success and 1 on failure | |
| msg | Submitted Successfully | Return result description, such as: Successfully Submitted | |
| data | taskid | 20000196 | Unique ID for printing tasks |
| printer_id | 500001 | Printer Unique ID | |
| order_id | 164679033555822 | The order ID of a third-party platform, supports a maximum of 32 characters | |
| status | 3 | Print Status，3:Cancell | |
This interface is developed by a third-party platform. The open platform transmits real-time messages of print tasks to this interface. The third-party platform needs to process different messages, such as printing, printing completion, printing cancellation, and printing failure. Third party platforms can process messages according to their different states.
| API Address | http://xxxx.com/api/callback |
| Request Method | POST |
| Parameter Name | Parameter value（Example） | Parameter Description |
|---|---|---|
| taskid | 20000196 | Unique ID for printing tasks |
| printer_id | 500001 | The unique ID assigned to the printer, with each printer assigned a different ID |
| order_id | 20000196 | Order ID in third-party application |
| status | 2 | Print Status 1:Printing 2:Completed 3:Cancell 4:Failure |
| msg | Completed | 根据任务status显示不同信息。 1:Printing 2:Completed 3:Cancell 4:Failure |
| Callback description | After receiving the return message, the third party needs to output confirmation information to complete the processing. If the processing result information is not output or the processing result is failed, the callback will repeatedly submit 5 to the callback interface within 2 hours, and the processing will be abandoned after 2 hours |
| Successful callback processing returns a string | success |
| Callback processing failed and returned string | fail |
This interface is developed by a third-party platform, and the open platform transmits the printer status to this interface, such as offline, online idle, printing, and failure of the printing software. Third party platforms can process messages according to their different states.
| API Address | http://xxxx.com/api/printerStatus |
| Request Method | POST |
| description | This API is developed by a third party platform, and the open platform sends print real-time messages to this API. The third party platform needs to process different messages |
| Parameter Name | Parameter value（Example） | Parameter Description |
|---|---|---|
| printer_id | 500001 | 打印机分配的唯一ID号，每一台打印都会分配一个不同的编号打印机状态回调功能 |
| status | 2 | Printer Status，0:Offline 1:Idle 2:Printing 3:Fault |
| msg | Completed | Display different information based on printer status 0:Offline 1:Idle 2:Printing 3:Fault |
| notice_time | 2022-07-19 17:08:30 | Notification Time |
| Callback description | After receiving the message, the third party needs to output confirmation information after processing is completed. If the processing result information is not output or the processing result is failed |
| Successful callback processing returns a string | success |
| Callback processing failed and returned string | fail |
UV cloud printing service provider with deep integration of software and hardware
Phone：137-5177-4454
Technical Support Email：info@colorpark.cn
Partner Recruitment：partner@colorpark.cn
Submit personal resume：hr@colorpark.cn
Solemnly declare: that Ruifengcai is the only official online promotion channel
Shenzhen Refinecolor Technology Co., Ltd.
Address: 9th Floor, Building E25, Tian an Shenchuanggu, No. 179, Fenggang Section, Dongshen Road, Fenggang Town, Dongguan City
© 2023 粤ICP备2020105617号-1