rustedf.cloud
Menú

Cómo generar un PDF desde HTML en Ruby on Rails

Publicado el 2 min de lectura

En Rails, convertir HTML en PDF suele significar añadir una gema que envuelve un binario de renderizado, y luego instalar ese binario y mantenerlo funcionando en desarrollo, en CI y en producción. Con una API es una petición HTTP, y la biblioteca estándar de Ruby ya la hace. Esta guía muestra una clase pequeña y un controlador que envía el archivo, con la API de rustedf.cloud.

Una clase pequeña sobre Net::HTTP

app/services/rustedf_pdf.rb
require "net/http"
require "json"
class RustedfPdf
class Error < StandardError; end
ENDPOINT = URI("https://api.rustedf.com/v1/render")
def self.render(template_id:, data:, locale: "es-ES")
request = Net::HTTP::Post.new(
ENDPOINT,
"Authorization" => "Bearer #{Rails.application.credentials.dig(:rustedf, :key)}",
"Content-Type" => "application/json"
)
request.body = { template_id: template_id, locale: locale, data: data }.to_json
response = Net::HTTP.start(ENDPOINT.host, ENDPOINT.port, use_ssl: true, read_timeout: 40) do |http|
http.request(request)
end
return response.body if response.is_a?(Net::HTTPSuccess)
raise Error, error_message(response)
end
def self.error_message(response)
JSON.parse(response.body).dig("error", "message") || "Error al generar (#{response.code})"
rescue JSON::ParserError
"Error al generar (#{response.code})"
end
end

Una respuesta correcta es el propio PDF, así que response.body es el archivo. En un fallo, el cuerpo es un JSON con un code estable y un message.

Guarda la clave en las credenciales cifradas (bin/rails credentials:edit) o en una variable de entorno, nunca en una vista ni en el navegador. Fija el tiempo límite de lectura por encima del límite de tu plan, para que tu petición no se rinda antes que el servicio.

Un controlador que envía el PDF

app/controllers/facturas_controller.rb
class FacturasController < ApplicationController
def show
factura = Factura.find_by!(numero: params[:numero])
pdf = RustedfPdf.render(
template_id: Rails.configuration.x.rustedf_invoice_template,
locale: "es-ES",
data: {
number: factura.numero,
customer: { name: factura.cliente.nombre },
total: factura.total.to_s
}
)
send_data pdf, type: "application/pdf", disposition: "inline",
filename: "factura-#{factura.numero}.pdf"
rescue RustedfPdf::Error => error
Rails.logger.error(error.message)
head :bad_gateway
end
end
config/routes.rb
get "facturas/:numero", to: "facturas#show", constraints: { numero: /[\w-]+/ }

Para enviar HTML en lugar del id de una plantilla guardada, usa html: en lugar de template_id:. Pasa todo lo que haya escrito un usuario por data, y no dentro de la cadena de HTML: los valores de data se escapan, y el propio HTML se lee como una plantilla. Si generas una vista como cadena antes, recuerda que el resultado vuelve a tratarse como plantilla.

Reintentar cuando el servicio está ocupado

Un 429 (límite de peticiones) o un 503 (ocupado) trae una cabecera Retry-After. Una generación que falla no gasta crédito, así que reintentar es seguro: lee response["Retry-After"], usa sleep ese número de segundos y envía la petición de nuevo, un número limitado de veces. Para un trabajo que no necesita responder al navegador al instante, ejecuta la llamada en un job en segundo plano y reintenta ahí.

Errores que conviene tratar

Estado code Qué hacer
401 unauthorized La clave falta, es incorrecta o está revocada.
402 insufficient_credits Se acabaron los créditos. No se generó nada.
422 invalid_template La plantilla o los datos fallaron. Lee el message.
429 rate_limited Espera el Retry-After y reintenta.
503 busy El servicio está ocupado. Espera el Retry-After y reintenta.
504 render_timeout El documento tardó más de lo que permite tu plan.

Ejecuta POST /v1/validate con el mismo cuerpo mientras construyes la plantilla: enumera todo lo que el servicio no admitió por completo, sin devolver el PDF ni gastar crédito.

Consulta Generar un PDF, Autenticación y Errores y límites.

← Todos los artículos