cURLを使ってPDFを画像に変換
目次
はじめに
以下のチュートリアルでは、ホスティングされたJPedalクラウドAPIを使ってPDFから画像を抽出する方法を紹介します。セルフホスト型のJPedalマイクロサービスをセットアップすることもできます。
以下の例では、URLに https://my-self-hosted-service.com/JPedal を使用していますが、これをあなたのホストするサービスのURLに置き換えてください。
上記のサービスには、REST APIを使ってcURLでアクセスすることができます。
前提条件
始める前に、cURLがインストールされていることを確認してください。セットアップはオペレーティング・システムによって異なりますが、詳細はcurlのウェブサイトを参照してください。
サンプルコード
PDFを画像に変換する基本的なコード例です。
ファイルエントリは、’@’の後にファイルへのパス ( 絶対または相対 ) が続く必要があることに注意してください。
設定オプションと高度な機能は以下をご覧ください。
curl -X POST -F input="upload" -F file="@/path/to/file/myfile.pdf" -F settings="{\"mode\":\"convertToImages\",\"format\":\"png\"}" https://my-self-hosted-service.com/jpedal
注：設定の形式は、お使いのプラットフォームによって異なります。下記の設定オプションを参照してください。
レスポンスはuuidを含むJSON形式となります。
{"uuid" : "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"}
抽出の進行状況をポーリングできます。抽出が完了したら、出力の URL を取得します。
curl https://my-self-hosted-service.com/jpedal?uuid=aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa
応答はJSON形式で、以下の詳細が提供されます。
{
"state" : "processed",
"downloadUrl" : "output/aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa/myfile.zip",
"previewUrl" : "output/aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa/myfile/index.html"
}
ブラウザで出力をプレビューするには、previewURLを使用できます。
また、downloadURLを使って変換された出力をダウンロードすることもできます。これは以下のcURLリクエストで実行できます。
# 名前を付けて現在のディレクトリにダウンロードします（この場合は "myfile.zip"）。
curl https://my-self-hosted-service.com/jpedal/output/aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa/myfile.zip -LO --output "output.zip"
結果をコールバックURLに返信
JPedal マイクロサービスは、抽出の完了時にステータスを送信するコールバック URL を受け付けます。コールバックURLを使用すると、抽出がいつ完了したかを判断するためにサービスをポーリングする必要がなくなります。
コールバックURLは以下のように指定します。
curl -X POST -F input="upload" -F callbackUrl="http://listener.url" -F file="@/path/to/file/myfile.pdf" -F settings="{\"mode\":\"convertToImages\",\"format\":\"png\"}" https://my-self-hosted-service.com/jpedal
設定オプション
JPedal APIは、抽出をカスタマイズするためのキーと値のペアの設定オプションを含む文字列化されたJSONオブジェクトを受け付けます。この設定は、cURLコマンドのURLの前に追加する必要があります。PDFからテキストを抽出するための設定オプションの完全なリストはこちらからご覧いただけます。
PowerShellの場合、解析エラーを避けるために、コマンドはcurl.exe --%で始まる必要があることに注意してください。
URLによるアップロード
ローカルファイルをアップロードするだけでなく、JPedalマイクロサービスがダウンロードして抽出を行うURLを指定することもできます。そのためには、inputとfileの値を以下のように置き換えてください。
-F input=download -F url="http://exampleURL/exampleFile.pdf"
認証の使用
PDFからテキストを抽出するためにユーザ名とパスワードを必要とする独自のJPedalマイクロサービスをデプロイする場合、変換のたびにユーザ名とパスワードを提供する必要があります。これらは、URLの前にユーザ名とパスワードを持つユーザフラグを追加することで提供されます。
--user username:password