57 筆 (第 3 頁,共 3 頁)
2026-04-27 app-registration oauth client getting-started
什麼是應用程式登錄

說明 ReceiptRoller 的應用程式登錄的概念。透過將應用程式登錄為 OAuth 用戶端,會發行用戶端 ID、密鑰、重新導向 URI,可開始 API、Webhook 串接。

2026-04-27 疑難排解 權杖 驗證 OAuth
無法取得權杖(驗證錯誤)

無法取得存取權杖時的原因釐清。解說 invalid_client、invalid_grant、redirect_uri_mismatch 等代表性錯誤與因應。

2026-04-27 API 請求 回應 JSON 分頁
請求與回應的基本(JSON)

解說 ReceiptRoller API 的請求格式、必要標頭、回應結構、分頁、篩選、日期時間格式的規則。

2026-03-27 API驗證 OAuth 2.0 授權碼 開發者指南
API 驗證指南

解說 ReceiptRoller API 的 OAuth 2.0 授權碼流程的驗證方法。

2026-04-27 Webhook 監視 警報 無效信件 故障對應
監視與失敗時的對應

解說 ReceiptRoller Webhook 的投放紀錄的檢視方式、應監視的指標與警報設計、無效信件的重新投放、常見故障模式與復原步驟。

2026-04-27 API 速率限制 429 節流
速率限制與節流

解說 ReceiptRoller API 的速率限制的單位、各方案的上限、回應標頭的解讀方式,以及為不觸及 429 的實作模式。

2026-06-01 API OAuth 營業額 KPI Analytics Android iOS averageTicket terminalId
營業額實績 API(Sales API)的使用方式

彙整 ReceiptRoller 營業額實績 API(/api/v1/sales/*)的概要,以及依商業帳戶、店鋪、POS 端末、期間的篩選方法。這是一份涵蓋實際回應結構(KpiValue 巢狀型)與 averageTicket、權杖有效期限(8 小時)在內,為在 Android/iOS 行動應用程式或伺服器串接實作營業額儀表板的入門指南。

2026-05-29 CRM 顧客 資料模型 參考 POS串接
CrmCustomerDto 參考

解說 ReceiptRoller 顧客主檔 CrmCustomerDto 的所有欄位。從 POS(Smaregi、Square)匯入的顧客資訊會正規化為此模型。

2026-04-27 正式運用 最佳實務 監控 部署
正式運用的最佳實務

解說在正式環境穩定運用 ReceiptRoller 串接應用程式的最佳實務(環境分離、監控、部署、故障因應、文件整備)。

2026-06-20 API Store 店鋪資訊 OAuth
店鋪資訊 API(Store Information API)的使用方式

說明如何以 REST API 取得、更新店鋪的基本資訊(店鋪名稱、店鋪類別、聯絡方式、地址)。可從員工應用程式等以權杖驗證的用戶端實作店鋪資訊的編輯畫面。

2026-04-27 api reference swagger openapi community
API 參考與文件的閱讀方式

說明 ReceiptRoller 的開發者向文件的構成與分別使用。開發者幫助、API 頂頁、Swagger 基底的 API 參考、開發者社群的 4 個入口,以及可用於 AI 助手或程式碼生成工具的 OpenAPI 規格(openapi/v1.json)的取得方法。

2026-04-27 疑難排解 User系權限範圍 審查
User 系權限範圍回傳 app_not_approved

使用 User 系權限範圍時回傳 app_not_approved 錯誤時的確認步驟。解說在沙箱框架下的開發、審查申請、沙箱轉正式環境的流程。

2026-04-27 API 範例 curl 收據取得
代表性的 API 範例

以 curl 命令介紹 ReceiptRoller API 代表性端點的呼叫範例(收據取得、店鋪一覽、商品建立、Webhook 登錄)。

2026-04-27 API 錯誤碼 重試 HTTP狀態
錯誤碼與重試指引

解說 ReceiptRoller API 回傳的 HTTP 狀態碼與錯誤碼的一覽、應重試的情況、重試間隔的指引。

2026-04-27 OAuth 重新導向URI 應用程式登錄 安全性
重新導向 URL 的設定

解說在 ReceiptRoller 的開發者入口設定的重新導向 URI(回呼 URL)的角色、登錄規則、開發與正式環境的分別使用、常見錯誤與因應方法。

2026-04-14 developer webhook receipt api integration
店鋪向:以自家應用程式發行數位收據、以 Webhook 通知的指南

解說店鋪、品牌以自家應用程式向顧客發行數位收據,到以 Webhook 接收即時通知為止的步驟。涵蓋應用程式登錄、OAuth、Webhook 設定、簽章驗證。

2026-05-26 OAuth Android iOS 行動 API 多商業帳戶 PKCE
原生行動應用程式指南:多商業帳戶存取與 OAuth 流程

Android / iOS 原生應用程式的實作指南。應用程式登錄時將「授權時將權杖關聯至 1 個商業帳戶」關閉,即會發行 user-scoped OAuth 權杖。以 /api/v1/me/organizations + ?organizationId= 模式即可跨多個商業帳戶存取。