Ruby HTML to PDF API

ruby -rnet/http -rjson -e '
  uri = URI("https://api.microlink.io?url=https://example.com&pdf=true&meta=false")
  puts JSON.parse(Net::HTTP.get(uri)).dig("data", "pdf", "url")'

require 'json'
require 'net/http'
require 'uri'

module Microlink
  Error = Class.new(StandardError)

  ENDPOINT = 'https://api.microlink.io'.freeze

  module_function

  def pdf_url(target)
    uri = URI(ENDPOINT)
    uri.query = URI.encode_www_form(url: target, pdf: true, meta: false)

    request = Net::HTTP::Get.new(uri)

    response = begin
      Net::HTTP.start(
        uri.host, uri.port,
        use_ssl: true, open_timeout: 10, read_timeout: 60
      ) { |http| http.request(request) }
    rescue Net::OpenTimeout, Net::ReadTimeout => e
      raise Error, "microlink: #{e.class}"
    end

    payload = begin
      JSON.parse(response.body.to_s)
    rescue JSON::ParserError
      raise Error, "microlink: #{response.code} #{response.message}: invalid JSON"
    end

    unless response.is_a?(Net::HTTPSuccess)
      raise Error, "microlink: #{response.code}: #{payload['message']}"
    end

    payload.dig('data', 'pdf', 'url') ||
      raise(Error, 'microlink: no pdf url in response')
  end
end

puts Microlink.pdf_url('https://example.com')

def pdf_params(target)
  {
    url: target,
    'pdf.format': 'A4',         # A0-A6 | Letter | Legal | Tabloid
    'pdf.margin': '0.35cm',     # cm, mm, in or px
    'pdf.landscape': false,     # portrait (default) | landscape
    'pdf.scale': 1,             # zoom the rendering, 0.1 to 2
    mediaType: 'print',         # print stylesheets (default) | screen
    meta: false
  }
end