電子レシートAPIにログイン

本日は電子レシートAPIのログイン方法を紹介します。

利用するAPIはこちらです。
https://api.receiptroller.com/index.html

まずはアカウント登録

まずAPIを使うためにはこちらでアカウントの登録が必要です。登録されていればどなたでもこのAPIの利用は可能です。アカウントの登録は下記URLで行うことができます。
https://receiptroller.com/identity/account/register?culture=ja

↓登録画面

↓仮登録完了画面

↓確認メール、確認メールのリンクをクリック

↓確認完了画面

一旦ここでログインできることを確認しましょう。

↓正常にログインできた後のトップページ

では、ここでAPIに戻り同じログイン情報でログインしてみます。

ログイン

ログインAPIを使うとアクセス用のtokenを取得することができます。これから先（ログアウト以外）のAPIを使うときはここで取得するtokenをheaderに付与する必要があります。

ログインリクエスト

早速ですがCurlのリクエストは下記です。

curl -X 'POST' \
  'https://api.receiptroller.com/account/login' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "userName": "YOUR EMAIL",
  "password": "YOUR PASSWORD",
  "expire": "2023-12-24T11:11:15.913Z"
}'

ここでのポイントは自分でトークンの有効期限を設定することができます。あまり長い期間を設定することはお勧めできませんが、何度もtokenを取得するのも面倒なので今回は24日までのtokenを取得します。

ログインレスポンス

↓ログインレスポンス

ここではtokenと有効期限が戻ってきます。この有効期限は自身で設定したものですが、戻ってきます。

ログインできているか確認

ログインできいるかどうか確認するために、/account/meというメソッドを呼んでみます。

me リクエスト

curl -X 'GET' \
  'https://api.receiptroller.com/account/me' \
  -H 'accept: application/json' \
  -H 'Authorization: bearer {YOUR TOKEN}'

me レスポンス

{
  "userName": "{YOUR USER NAME}",
  "roles": []
}

正常に自身のUserNameが表示されていればOKです。

次

明日は企業登録を試してみます。
https://qiita.com/receiptroller/items/b32096696ec92c89905b

採用中

現在開発メンバー絶賛募集中です。紙レシート削減を目指して電子レシートの開発を一緒に進めるメンバーを募集しています。フルリモートです。詳細はこちら。　
https://receiptroller.com/ja/jobs