QRコードAPI｜動的コードとスキャン分析をプログラムから
ダッシュボードと同じ仕組み、つまり動的コード、リンク先の編集、スキャンログを、Businessプランで自社のソフトウェアから利用できます。
QRmkrの動的コードは2つのシンプルな要素で成り立っています。あなたが管理する恒久的な短い転送先と、すべてのアクセスを記録するスキャンログです。BusinessプランのAPIアクセスは、その要素を自社システムから扱えるようにします。人がダッシュボードを操作しなくても、コードの作成、転送先の変更、スキャン分析の読み取りをソフトウェアから実行できます。スキャンデータは現時点で、認証付きの単一エンドポイントからCSVとして取得できます。詳細は以下のとおりです。
できること
自社スタックから動的コードを扱う
BusinessプランのAPIアクセスでは、動的コードの生成と、恒久的な転送先の変更をプログラムから行えます。ダッシュボードでの編集と同じ操作です。
スキャン分析の取得
スキャンごとに時刻、端末種別、OS、ブラウザ、おおまかな位置を記録します。コードのスキャンログ全体を認証付きエンドポイントからCSVで取得し、データウェアハウスやBIツールに読み込めます。
標準的でシンプルな認証
リクエストはアカウントのセッショントークンで認証します。ログイン時に発行される30日間有効なJWTで、HTTP-only Cookieとして送られます。ふつうのHTTPSリクエストだけで、SDKは不要です。
使い方
- 1
Businessにアップグレードします。APIアクセスは、5名のチーム席とカスタム短縮リンクドメインとともに含まれています。
- 2
認証します。ログインしてセッショントークン（30日間有効なJWT）を取得し、リクエストにqrm_session Cookieとして付与します。
- 3
データを取得します。エクスポート用エンドポイントから任意のコードのスキャンログをCSVで取得し、業務フローを自動化します。
よくある質問
QRmkrのQRコードAPIでは何ができますか？
APIアクセスはBusinessプランの機能で、動的QRコードのプログラム利用、つまりコードの作成、リンク先URLの更新、スキャン分析の取得をカバーします。このページに記載したスキャン分析のエクスポートは現在稼働中です。Businessプランを開始したらsupport@qrmkr.ioまでご連絡いただければ、連携の準備をお手伝いします。
APIの認証はどう行いますか？
アカウントのセッショントークンを使います。ログインすると30日間有効なJWTが発行され、qrm_sessionという名前のHTTP-only Cookieとして渡されます。連携側のリクエストにそのCookieを付けてください。トークンはアカウント全体へのアクセス権を持つため秘密に保ち、APIは必ずHTTPSで呼び出してください。
スキャン分析のエクスポートには何が含まれますか？
スキャン1件につきCSVの1行です。時刻、端末種別、OS、ブラウザ、国、都市、リファラーが入ります。位置は国と都市レベルのおおまかなもので、生のIPアドレスではなくソルト付きハッシュを保存しています。
APIアクセスはどのプランに含まれますか？
Business、月額$39（年払いなら実質月$32）です。Proのすべて、つまり無制限の動的コード、リンク先の編集、スキャン分析に加えて、最大5名のチームメンバー、カスタム短縮リンクドメイン、APIアクセス、AIアートQRの上限引き上げが含まれます。
QRコードを自社のパイプラインに組み込みませんか
APIアクセスはBusinessプランに含まれます。月額$39、Proのすべてを含み、いつでも解約できます。
Businessの料金を見る