フリップブックをパスワードで保護する
アクセス制御1回のAPI呼び出しで、フリップブックのパスワード保護をオン・オフし、パスワード画面(タイトル、入力欄のプレースホルダー、ボタン)をカスタマイズできます。
このディスカッションで使うAPI
このガイドに誤りや古い情報がありますか?
できること
パスワード保護は、フリップブックの前にゲートを設けます。ビューアーは、コンテンツが読み込まれる前に正しいパスワードを入力する必要があります。1回のAPI呼び出しで、次のことができます。
- 保護をオンにして、アクセス用パスワードを設定する。
- 保護を再びオフにする。
- パスワード画面をカスタマイズする — 見出し、入力欄のプレースホルダー、ボタンのラベル。
始める前に
必要なものは次のとおりです。
- APIキー — すべてのリクエストで
X-Api-Keyヘッダーとして送ります。 flipbookId— フリップブックの作成時(IDとして)や一覧エンドポイントから返される数値IDです。- リクエストの送信先はベースURL
https://go.fliplink.meです。
ボディはform-urlencoded(JSONではありません)です。
パラメーター
次のフィールドをurlencodedでPUT /api/set-password-access/{flipbookId}に送ります。
| フィールド | 型 | 動作 |
|---|---|---|
IsPasswordProtected | boolean | trueでパスワードゲートをオン、falseでオフ |
Password | text | ビューアーが入力するアクセス用パスワード |
PwdTitle | text | パスワード画面に表示する見出し(任意) |
PwdPlaceholder | text | パスワード入力欄内のプレースホルダー(任意) |
PwdButton | text | 送信ボタンのラベル(任意) |
パスワード保護をオンにする
IsPasswordProtected=trueを設定し、Passwordを指定します。3つのPwd*フィールドは任意です。ビューアーに表示される内容をカスタマイズしたい場合に含めてください。
curl -X PUT 'https://go.fliplink.me/api/set-password-access/96216' \
-H 'X-Api-Key: YOUR_API_KEY' \
--data-urlencode 'IsPasswordProtected=true' \
--data-urlencode 'Password=spring-2026' \
--data-urlencode 'PwdTitle=Enter the access code' \
--data-urlencode 'PwdPlaceholder=Access code' \
--data-urlencode 'PwdButton=View document'
レスポンス:
{ "Result": "OK", "Message": "Updated successfully" }
パスワード保護をオフにする
IsPasswordProtected=falseを設定します。他のフィールドは空のままで構いません。
curl -X PUT 'https://go.fliplink.me/api/set-password-access/96216' \
-H 'X-Api-Key: YOUR_API_KEY' \
--data-urlencode 'IsPasswordProtected=false' \
--data-urlencode 'Password=' \
--data-urlencode 'PwdTitle=' \
--data-urlencode 'PwdPlaceholder=' \
--data-urlencode 'PwdButton='
レスポンス:
{ "Result": "OK", "Message": "Updated successfully" }
パスワード画面のカスタマイズ
PwdTitle、PwdPlaceholder、PwdButtonの各フィールドで、ゲートを対象者に合わせて調整できます。たとえば、クライアントポータルでは「アクセスコード」と呼んだり、ブランドのトーンに合わせたりできます。これらは任意です。省略する(または空で送る)と、デフォルトが使われます。
起こりうるエラー
- APIキーが欠けているか無効な場合 → HTTP
401。これはプレーンなUnauthorized HTMLページを返し、JSONボディはありません。X-Api-Keyヘッダーが存在し、正しいことを確認してください。 - 不明な
flipbookId(またはキーが所有していないもの) → HTTP200で{ "Result": "ERROR", "Message": "Item not found" }。 - ボディのフィールド名のスペルミス → HTTP
200で{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }。上の表とフィールド名を照らし合わせて確認してください。
メモ
- パスワードは別経路で共有してください。 フリップブックのリンクとパスワードは、別々のチャネルで送りましょう。リンクと同じメールに含めたパスワードは、ほとんど保護になりません。
- パスワード保護は1つの層にすぎません。 制御するのは入場であって、ビューアーが誰かではありません。特定の人だけにアクセスを制限するにはメール許可リストと組み合わせ、アクセスに期限を設けるにはリンクの有効期限と併用してください。