Web API

We are implementing the Ricoh application to trigger print job by firing the "POST http://gw.machine.address:port/rws/service/printer/jobs" print web call with print file path url. The question is about the situation when multiple print jobs are involved.

As per the description for the print sample code in Ricoh SDK, it appears that a new job can be executed only when the printer state is IDLE, does that mean that in order to call the print web call to trigger the second job we have to wait for the first job is fully completed (physically printed out)?

When doing testing we notice that even when a job is being printed out in background, we could still call the print web api to trigger a new print job, finally both jobs are printed out in order.

As we know, when a job is triggered by the print web call, the ongoing job status for this job would be pending (pull file stream based on file path url), processing and completed. Can we call the print web api to trigger the second job by following the steps as below?  Or, does Ricoh have any recommendations if we want to speed up the printing for multiple jobs?

1. Use print web api to trigger the first job.

2. Wait for the job status event for the first job.

3. The application receives the job status events and confirm the file stream pulling has been completed  for the first job as per the job status events. 

4. When the first job is still being printed (not receive "completed" job status event yet), use print web api to trigger the second job.

Thank you.

We are going to start with the development of our application. Our application is going to run in the Web Browser NX and it’s going to use the JS API to interact with the printer.

I noticed we need an access token to use the scanner.

How can we get the access token? I read in the documentation that we need to fill a form and Ricoh is going to provide us the token, but first we need a product ID.

Could you please let me know where I can fill the form and how to get the product id?

Also, I would like to know how is the process to get the final release signs and tokens.

Hello,

Is there any API that we can use to query the device to determine what SOP generation version it is running?  For example G2.0, G2.5, or G3.0. 

The reason for this is that we need to figure out if the javaVM is used on the device or not.  

Hello,

Is there any API I can use to install a CA certificate? 

in SDK doc SmartSdk_DevKit_R2209/doc/en/webapi/320-04-0100.htm, it indicates "Scanned image file is automatically deleted when passing 15 minutes*1 after the last execution of API*2 for the job resource of "scan and store" (/rws/service/scanner/jobs/{job ID})."

but in SmartSdk_DevKit_R2209/doc/en/guide_web/300-02-0100.htm, it indicates "When "jobMode = scan_and_store_temporary" is specified for starting the scanner job, unnecessary image files must always be deleted by using this API. If not deleted, the machine may not be able to go to Energy Saver mode or the memory full error may occur."

Could you please clarify in what case the scanned image file would be deleted automatically and in what case the scanned image file must be deleted manually with DELETE WebApi call.

Thanks.

Question regarding remote Web API calls for scanning using basic authentication. Is there a way calls these services when the device is configured to use Custom Authentication?

We looked into using Authentication Token (X-SS-AuthToken) instead, but the SDK documentation states that “An authentication token is generated at the time a user logs in from operation panel, and the token remains effective until the user logs out.” This is an issue, since the completion a scan job could take longer than user session on the device.

We cannot use scan with USER_AUTHENTICATION__SCANNER set to OFF, so authentication is required for remote Web API calls.

Is there way to get the rws WebAPI working on the Ricoh emulator.

Kent

Hello,

We are developing a remote app to control device's scanner with WebAPI. we are able to start scan with "POST http://<deviceIP>/rws/service/scanner/jobs".

Could you please let us know if there is a way to make the device to notify the remote app whenever scan job state and/or scanner state changes? 

Thanks.

Hi Team,

I was experimenting with scanner apis and sample application I got stuck in one scenario where I am trying to get scanned file using following api.

GET /rws/service/scanner/jobs/{Job ID}/file with job id of scanning job that have "completed" status for example job id like "S1650962864178".

But I am always getting the same error while doing this api call it always sends me 404 error as status code and following as body of response.

{
    "errors": [
        {
            "message_id": "error.path_no_exist",
            "message": ""
        }
    ]
}

I tried this api with real printer and emulator both are giving me same result. Can you please guide me what I am doing wrong here. I want to get file path of scanned file.