How to POST a document in binary format?

Question

Hello World, 
 I am looking for a way to make a Rest API call to post a document. 
 The document need to be converted in binary. 
 Best

aloks0189 · Answer

Hi Sebastien Mayemba as per my understanding File upload smart service is the best choice in your case. 
 
I will not recommended you to go for Base64 approach because of following reasons: 
 
1. Generally when we convert a document to Base64 then the output document size will be much bigger than the actual one 
 
2. When Base64 conversion happens, entire output Base64 data will be stored in memory instead of streaming it, which is why it's a memory intensive operation. 
 
3. If we are dealing with multiple and huge file operation, Base64 will impact the server performance a lot 
 
Solution: we should be able to stream the Document in Binary format, which can be done by using upload file smart service. 
 
Hope this will help

aloks0189 · Answer

Hi @rameshg647 this can happen in following cases: 
 1. When conversion of the document to Base64 didn't happen properly 
 2. While converting Base64 back to document in SharePoint: there might be something wrong they might have coded in SharePoint 
 Alternate option: Why don't you give a try to http file upload smart service which is OOTB. This accepts headers , endpoint , basic authentication (if any) and the document. Here authentication can be done using integration object and the response header ( key and value) you can pass to this smart Service , that should do your job. 
 And in fact, if Base64 is not only your requirement, then HTTP file upload smart service is the best option for you, because it stream the document in binary instead of converting and storing the entire document in memory (causes performance issues) which is being done by Base64 smart service. 
 Hence If the target system is not expecting the document in Base64 format then I recommend you better go for http file upload smart Service. 
 Hope this will help

aloks0189 · Answer

rameshg647 You need to leave basic authentication input parameter empty, you just need to pass the headers, and in order to get the headers, authentication is required which will be done by Integration Object. Below are the steps to achieve this.

1. Create an Integration Object which is responsible to perform the Authentication
2. Call this integration Object in process model and get it's response, parse it
3. Set the required headers Keys (let's say, OAuth, Cookie etc..) into HTTP File Upload Smart Service Headers Key and it's header values will be your parsed response (which you have got after authentication using Integration Object/or by any other authentication approach)
4. set the endpoint of file upload

And you are done, you will be able to upload the document to Sharepoint/any other system successfully.

NOTE:
1. HTTP File upload is a generic smart service which will work for most of the services, if we are able to provide the proper header details about the target system

2. This is the reason, basic authentication input parameter is marked as not required in this Smart Service.

Hope this will help.