本日は電子レシート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