[tomasr78]

Two examples call converters that the production API spec (https://v2.convertapi.com/info/openapi, 332 paths on 2026-11-09) does not list. Both still convert today, but developers copy these examples and the how-to guides on convertapi.com reuse them, so they should call documented converters. This is the Ruby part of what ConvertAPI/convertapi-library-dotnet#86 does for .NET.

Example	Before	After
convert_url_to_pdf.rb	web -> pdf, comment links /web-to-pdf	html -> pdf (parameters), same Url and FileName; comment links https://www.convertapi.com/html-to-pdf
conversions_chaining.rb	any -> zip: with no source format the library sends every zip conversion to any	file -> zip (parameters): from_format: 'file', same Files

https://www.convertapi.com/web-to-pdf is not in the site's sitemap; https://www.convertapi.com/html-to-pdf is. The other examples already call documented converters; the pdf -> extract step of create_pdf_thumbnail.rb goes away with #42.

Verified against production (2026-11-09)

Ruby 3.4.12 in Docker (ruby:3.4-slim): each example ran with ruby -I../lib <name>.rb from examples/, once on main (7e10d69) and once on this branch, with the token in API_TOKEN and TMPDIR=/out. The [trace] lines come from a -r helper that prints each request's path; they are not part of the examples' output.

conversions_chaining.rb on this branch:

Converting PDF to JPG and compressing result files with ZIP
[trace] POST v2.convertapi.com/upload -> HTTP 200
[trace] POST v2.convertapi.com/convert/pdf/to/jpg -> HTTP 200
Conversions done. Cost: 1. Total files created: 6
[trace] POST v2.convertapi.com/convert/file/to/zip -> HTTP 200
Conversions done. Cost: 1. Total files created: 1
File saved to ["/out/test.zip"]

On main the output is the same except the ZIP request, POST v2.convertapi.com/convert/any/to/zip. Both runs saved a 775,249-byte test.zip with test.jpg to test-6.jpg; the JPGs are byte-identical before and after.

convert_url_to_pdf.rb on this branch (on main the request was /convert/web/to/pdf, the rest the same):

[trace] POST v2.convertapi.com/convert/html/to/pdf -> HTTP 200
The web page PDF saved to ["/out/web-example.pdf"]

The PDF text: on this branch the PDF is the article (3 pages, 1,925 words, title "Data conversion"). On main, Wikimedia answered ConvertAPI's renderer with its "Too many requests" page (1 page, 62 words); that rate limiting comes and goes for both converters and is being looked at separately.

Seen, not changed: the library itself still picks undocumented converters when no source format is given: any for every zip target (lib/convert_api/format_detector.rb) and url when the parameters have a Url (lib/convert_api/task.rb). The examples now pass the source format, so they do not depend on it.

Same change in the other SDKs

• Go: Examples: use the converters the API spec documents convertapi-library-go#22
• Java: Examples: use the converters the API spec documents convertapi-library-java#58
• Node: Examples: use the converters the API spec documents convertapi-library-node#125
• PHP: Examples: use the converters the API spec documents convertapi-library-php#73
• Python: Examples: use the converters the API spec documents convertapi-library-python#62
• .NET: Examples: use documented converters, read the production catalog, save SplitPDF to temp, hide account secrets convertapi-library-dotnet#86
• JS (browser): no change needed; its README calls only documented converters.

🤖 Generated with Claude Code

[Copilot]

🟢 Approval recommended

There are no active review issues for the updates to the two ConvertAPI examples.

No open issues 🎉

What changed in this PR

Updates two Ruby examples to use documented ConvertAPI converters without changing library behavior or conversion parameters.

Changes:

• Uses explicit html source format for URL-to-PDF conversion and updates the documentation comment link.
• Uses explicit file source format when compressing converted JPG files into ZIP.

File	Description
examples/​convert_url_to_pdf.rb	Switches from web to html and links to the HTML-to-PDF documentation.
examples/​conversions_chaining.rb	Sets from_format: 'file' to avoid the implicit any-to-ZIP converter.

_{Review effort: Balanced}