Академический Документы
Профессиональный Документы
Культура Документы
http://173.33.180.172/cgi-bin/kpdfc/v3process.exe
Protocol:
HTTP POST
Parameters:
1. Basic Parameters Name UsernameEntry password referer sendtoemail kpasagent oemVar1 oemVar2 oemVar3 oemVar4 emailUserRetrievalLinks Required Yes Yes Yes Yes Yes No No No No Yes Note The username for the API The password for the username A predefined string to identify the application. For example: drupalconnector The email address for notification mail The token code to identify the application Custom field for the app Custom field for the app Custom field for the app Custom field for the app Send the download links in the notification email. Currently, its value should be 2 The value should be 2pdf for conversion. PDF
whatToProcess ufile
Yes Yes
The binary of the source files to be converted into PDF. The files should be packaged into a ZIP file. Whether to embedded watermark. Options: 1 Yes 0 - No The text color style for the watermark. Options: 0 - Red Outline Font Above Text 1 - Green Outline Font Above Text
WatermarkCheckbox
Yes
WatermarkColor
No
2 - Blue Outline Font Above Text 3 - Light Red Solid Font Behind Text 4 - Light Green Solid Font Behind Text 5 - Light Blue Solid Font Behind Text 6 - Light Grey Solid Font Behind Text
(This will work if WatermarkCheckbox is 1)
WatermarkText EncryptionLevel
No Yes
Different Encryption Level. Options: 0 No 1 40 bit 2 128 bit The generated PDFs password for the owner
(This will work if EncryptionLevel is 1)
OwnerPassword UserPassword
No No
AllowPrinting
No
AllowCopying
No
AllowChanging
No
pdfQuality
Yes
The quality of the generated PDF Options: 0 - Basic (Screen Optimized) 1 - Average (eBook Optimized) 2 - Excellent (Print Optimized) 3 - Best(Prepress Optimized) The degree to be rotated. Options: 0 90 180
pdfRotateDegrees
Yes
270 pdfCrop Yes Indicate how to crop the pages: Options: 0 - No PDF Cropping 1 - Crop All White Space 2 - Crop Leave 0.5 inch Space 3 - Crop Leave 1 inch Space 4 - Crop Leave 2 inch Space 5 - Crop Leave 3 inch Space 6 - Crop All Pages To Min Common Size All White Space 7 - Crop All Pages To Min Common Size 0.5 inch Space 8 - Crop All Pages To Min Common Size 1 inch Space 9 - Crop All Pages To Min Common Size 2 inch Space 10 - Crop All Pages To Min Common Size 3 inch Space Indicate how to resize pages: Options: 0 - No PDF Resizing 1 Resize To 75% Of Original 2 Resize To 50% Of Original 3 - Resize To 25% Of Original 4 - Resize To Fit In A0 Sheet 5 - Resize To Fit In A1 Sheet 6 - Resize To Fit In A2 Sheet 7 - Resize To Fit In A3 Sheet 8 - Resize To Fit In A4 Sheet 9 - Resize To Fit In Letter Sheet 10 - Resize To Fit In Tabbloid Sheet 11 - Resize To Fit In C-Size Sheet 12 - Resize To Fit In D-Size Sheet 13 - Resize To Fit In E-Size Sheet Compress the page. Options: 1 Yes 0 - No Rasterize pages. Options: 1 Yes 0 - No The callback URL for the conversion request. * If its empty, the server will call to the default one.
pdfResize
Yes
jbig2Compress
Yes
pdfRasterize
Yes
overrideHttpPostToUrl
No
post2pdfTextExtract2Speech aggregatePdfs
Yes No
It should be 0 for this operation. signifying to aggregate all pages in zip in a final pdf output. Options: 1 Yes aggregate intrazip files into 1 pdf 0 Not aggregating, simply returning all converted pdfs individually create flash swf out of result Pdf:. Options: 0 not creating swf 1 create single swf file 2 - starburst each and every page of the subject PDF to individual swf files, and we zip them up The hash of the parameters (including the file data of the uploaded ZIP file)
convertToSwf
No
securitycode
Yes
2. File Type Parameters 1. .pub (MS Publisher) Name pubPrintCropmarks Required No Note Print Cropmarks, Options: 1 Yes 0 - No Rasterize and Convert, Options: 1 Yes 0 - No Readjust Publication for PDF/Flipbook Viewing Compatibility, Options: 1 Yes 0 No Publication PageSize Override Options: Letter Legal A0 A1 A2 A3 A4 A5 A6 C1 C2 C3
pubRasterizeNConv
No
pubPublicationTypeResetCustom
No
pubPrnFormOverride
No
C4 C5 C6 pubCompressPicLevel No Compress picture Level Options: 0 - Compress To 200dpi 1 - No Compression (Default) 2 - Compress To 96dpi
2.
.ppt, .pptx, .pps, .pptm (MS Powerpoint) Name Required No Note Rasterize and Convert, Options: 1 Yes 0 No Convert Slides Per Page Handout Options: 1 - 1 Slides PP Handouts 2 - 2 Slides PP Handouts 3 - 3 Slides PP Handouts 4 - 4 Slides PP Handouts 5 - 5 Slides PP Handouts 6 - 6 Slides PP Handouts Convert Presentation Options: 1 Yes 0 No Remove Presentation Options: 1 Yes 0 No Background Color Options: 0 White 1 Black 2 Blue 3 Green 4 - Red Convert Presentation Options: 1 Yes 0 No With Notes. in Black/White.
pptRasterizeNConv
pptSlidesPerPageHandout
No
pptPrintBlackAndWhite
No
pptRemoveBackground
No
Background.
pptBackgroundColorToSet
No
pptPrintComments
No
pptConvertWithBookmarksLinks
No
0 No 3. .dwg, .dxf (CAD) Name cadPageSize Required No Page Size. Options: Letter Legal A0 A1 A2 A3 A4 A5 A6 C1 C2 C3 C4 C5 C6 ARCHA ARCHB ARCHC ARCHD ARCHE Page Orientation, Options: 0 Auto 1 Portrait 2 - Landscape Pen Width (in mm). Options: 0.05 0.15 0.20 0.25 0.2540 (Default) 0.30 0.40 0.50 0.60 0.70 0.80 0.90 1.00 Note
cadPageOrientation
No
cadPenWidth
No
1.20 1.40 1.58 2.00 cadPlotArea No Plot Area. Options: display extents (Default) window limits Visual Style. Options: 2d - 2D Wireframe 3dh - 3D Hidden 3dw - 3D Wireframe cpt Conceptual real - Realistic View. Options: current top bottom left right front back sw isometric se isometric ne isometric nw isometric
cadVisualStyle
No
cadView
No
4.
.html, .htm, .xps, .mht Name Required No Note Conversion in Landscape. Options: 1 Yes 0 No HTML PageSize to Use. Options: Letter Legal A0 A1 A2 A3 A4 A5 A6 C1
iePrintOrientation
iePrnFormOverride
No
C2 C3 C4 C5 C6 iePrnHtmHeader iePrnHtmFooter 5. .mdi Name mdi2pdfvitif Required No Note Rasterize MDI before converting. Options: 1 Yes 0 No Convert Annotation. Options: 1 Yes 0 No No No The text for the header of page The text for the footer of page
mdiConvAnnotation
No
6.
.xls Name Required No Note Fit Sheet In PDF Page. Options: 1 Yes 0 No
xlsFitSheet
7.
.doc, .docx, .docm Name Required No Options: 0 - converts via Open Office 1 - converts via Ms Word (default) Only effective when parameter doc2pdfviMsword is set to 1. Convert Doc Hyperlinks via Ms Word options: 0 No (default) 1 - Yes Note
doc2pdfviMsword
doc2pdfLinksviMsword
No
3. PDF Catelog catalogging is an universal setting which applies to all filetypes, not specific to any file type extensions. Name pdfCatalog Required No Note to do pdf catalogging or not. Options: 0 No (default) 1 - Yes Number of Columns. Max is 10 and min is 1 Number of Rows. Max is 10 and min is 1
catalogNumHoriz catalogNumVert
No No
catalogPageSize
No
Catalog Page Size. Options: Letter Tabloid A0 A1 A2 A3 A4 C-size D-size E-size Catalog Page Orietation. Options: P Portrait L Landscape Auto Rotate Input Page Options: 1 Yes 0 No Left Margin. Integer between 0 and 5 Right Margin. Integer between 0 and 5 Top Margin. Integer between 0 and 5 Bottom Margin. Integer between 0 and 5 Horizontal Spacing. Integer between 0 and 5 Vertical Spacing. Integer between 0 and 5 Whether to have border color. Options: 1 Yes 0 No The red part of border color: - integer value between 0 255 Usually presenting a color palette of some sort allowing users to pick the actual color, from there behind the scene it got broken down to the actual values. Do not submit hex values. The green part of border color: - integer value between 0 255 The blue part of border color: - integer value between 0 255 Whether to have line color. Options: 1 Yes 0 No
catalogPageOrientation
No
catalogAutoRotateInputPage
No
No No No No No No No
catalogDrawBorderColorRed
No
No No No
No No No
The red part of line color: - integer value between 0 255 The green part of line color: - integer value between 0 255 The blue part of line color: - integer value between 0 255
your overrideHttpPostToUrl
"status" could be failed, not always success
you can read parameter "numOfLinks" first from return callbacks to determine the number of retrieval links in this particular postback
"intraZipChapterTag" works like this, since you could send in a zip file with multiple intra zip files, after we sorted them based on filename and some level of intelligence e.g. files could be file1.doc, file2.doc, file3.doc, etc... or kkkk1.ppt, kkkk2.ppt, kkkk3.ppt, kkkk4.doc... etc we sort them correctly, in the end we may post retrieval links individually (i.e. separately) since they are being processed individually by different servers. But in order for your end to realize they belong to the same submission but just a chapter conversion, we add this parameter. Let's say you submit a file abc.zip which contains files file1.doc, file2.doc, file3.doc, but you also set "aggregatePdfs" to 0, i.e. not aggregating all intra-zip files into a single pdf,
then in such situation, our servers will convert all files file1.doc, file2.doc and file3.doc individually and post back individually. The question is how on your end do you feel you are going to handle the return postbacks? Does file1.pdf come in, then file2.pdf come in replacing file1.pdf as the conversion result of such conversion? then moments later, file3.pdf comes in, do you then replace file2.pdf as the conversion result for such conversion? It really depends how you presents the pdfs in the end to the end users. oemConsumer presence which presents all conversions in a flipbook case it is not just aligning the pdf files for users to download in a table instead it presents as different chapters within a big flippable ebook so one chapter to another. e.g. we have an format :) in such of some sort, but user can go from
Protocol:
HTTP POST
Parameters:
Name UsernameEntry password referer sendtoemail kpasagent oemVar1 oemVar2 oemVar3 oemVar4 emailUserRetrievalLinks Required Yes Yes Yes Yes Yes No No No No Yes Note The username for the API The password for the username A predefined string to identify the application. For example: drupalconnector The email address for notification mail The token code to identify the application Custom field for the app Custom field for the app Custom field for the app Custom field for the app Send the download links in the notification email. Currently, its value should be 2 The .txt file with the text to be converted into MP3 The value is upload The voice in speech: Options: Dave Kenneth Elizabeth Ryan The number of pages to be converted The value should be 1 The value should be text2speech convertion 2wav for