はじめに
pdfg とは
pdfg は HTML を PDF に変換するための API サービスです。サーバーレスアーキテクチャを採用し、低コストでスケーラブルな PDF 生成環境を提供します。
使い方
1.アカウントの作成
https://pdfg.net/signup から アカウントを作成します。 アカウントの作成には以下の手順が必要です:
- メールアドレスとパスワードを入力
- 認証用メールの確認
- メール内のリンクをクリックして認証を完了
- https://pdfg.net/signin からログイン
2.API キーの取得
ログイン後、管理画面に自動作成された「First Project」が表示されます。 このプロジェクトの API キーを使用して、最初の API リクエストを実行できます。
3.API リクエストの実行
以下は cURL を使用した API リクエストの例です:
curl --location 'https://api.pdfg.net/v1' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data '{"html": "<h1>Hello World</h1>"}' \
--output pdfg.pdf
各開発言語でのサンプルコードも用意しています。ご使用の環境に合わせてご確認ください。
pdfg の特徴
pdfg は単一のエンドポイント POST https://api.pdfg.net/v1
を提供します。
このエンドポイントは以下の機能を持ちます:
- JSON 形式で HTML とオプションを受け取る
- 生成した PDF のバイナリデータを返却する
生成された PDF データはその後ストレージに保存したり、ユーザーにダウンロードさせるといった用途が想定されますが、pdfg は PDF 生成に特化したサービスとして、PDF 生成までをスコープとしております。