読み方のヒント

矢印ボタン(または ← → キー)でページを移動できます。

第4節 読み込み中・失敗・空の状態

4.1 4つの状態

APIからデータを受け取る画面には、4つの状態があります。

状態起きるとき自分の予約一覧での表示
読み込み中応答を待っている「予約を読み込んでいます」
成功(データあり)予約が1件以上ある予約の一覧
成功(空)予約が0件「予約はまだありません」と「商品を見る」のボタン
失敗通信やサーバーの失敗「予約を読み込めませんでした」と「もう一度読み込む」のボタン

空のときに何も表示しないと、読み込み中なのか、失敗したのか、本当に予約がないのかが分かりません。空のときは、空であることと、次にできることを書きます。

失敗の文言には、何が起きたかと、何をすればよいかを書きます。

よくない文言よい文言
エラーが発生しました予約を読み込めませんでした。通信のよい場所で、もう一度読み込んでください。
503ただいま予約を受け付けられません。時間をおいてお試しください。

状態コードの数や、英語のエラーの文を、そのまま客に見せません。APIが返す code ごとに、画面の文言を一覧にしておくと、同じ失敗にはいつも同じ文言を出せます。たとえば deadline_passed なら「予約は受け取りの前日20:00までです。受け取りの日付を選び直してください。」とし、受け取りの日付の欄の下に表示します。

14 / 20