Image to PDF in Ruby

This page describes how to use our cloud-based API to convert images to PDF in Ruby. The API is user-friendly and can be integrated into your application with just a few lines of code.

Sample Output
sample JPG
JPG Image ⇒ sample PDF
PDF

Installation

The Ruby API client library provides easy access to the Pdfcrowd API. No third-party libraries are required.

Install the client library from rubygems.org
gem install pdfcrowd

We also offer other installation options.

Authentication

The credentials to access the API are your Pdfcrowd username and the API key.

API Method Reference

Refer to the Image to PDF Ruby Reference for a description of all API methods.

Code Examples

Here are a few Ruby examples to get you started quickly with the API. See more examples. 

require "pdfcrowd"

begin
    # create the API client instance
    client = Pdfcrowd::ImageToPdfClient.new("your_username", "your_apikey")

    # run the conversion and write the result to a file
    client.convertFileToFile("/path/to/logo.png", "logo.pdf")
rescue Pdfcrowd::Error => why
    # report the error
    STDERR.puts "Pdfcrowd Error: #{why}"

    # rethrow or handle the exception
    raise
end
require "pdfcrowd"

begin
    # create the API client instance
    client = Pdfcrowd::ImageToPdfClient.new("your_username", "your_apikey")

    # run the conversion and write the result to a file
    client.convertUrlToFile("https://pdfcrowd.com/static/images/logo.png", "logo.pdf")
rescue Pdfcrowd::Error => why
    # report the error
    STDERR.puts "Pdfcrowd Error: #{why}"

    # rethrow or handle the exception
    raise
end
require "pdfcrowd"

begin
    # create the API client instance
    client = Pdfcrowd::ImageToPdfClient.new("your_username", "your_apikey")

    # run the conversion and write the result to a file
    client.convertRawDataToFile(open('/path/to/logo.png', 'rb').read(), "logo.pdf")
rescue Pdfcrowd::Error => why
    # report the error
    STDERR.puts "Pdfcrowd Error: #{why}"

    # rethrow or handle the exception
    raise
end

Troubleshooting