分析Ricoh GR3x無線檔案傳輸

11 May 2024

前陣子終於拿到我心心念念的理光 GR3x，在購買前做過的功課中，看到不少人都有提到的一個問題是官方的 APP 很難用。

那我就有點好奇了，根據我對各種手邊 3C 產品的認識，這類的無線傳輸方法應該都不會太複雜，大概都是一個小小的 HTTP Server 而已，我搞不好有能力自己弄一個非官方的程式給自己用。

既然官方有製作 APP，那就表示一定有 API 可以呼叫，重點就是找到端點名稱，還有 API 有沒有任何驗證機制。於是我就上網查了一下 Ricoh/Pentax API 相關的關鍵字，還真的找到不少人嘗試過類似的事情。

作法

首先，API 的站台位在

http://192.168.0.1/

電腦要先跟相機的 WIFI 連線

而 API 無須任何驗證流程，直接使用網頁瀏覽器就可以打開了。

[GET] /v1/photos

這邊會拿到資料夾名稱，與資料夾底下的照片名稱列表構成的 JSON，稍後會用到

[GET] /v1/photos/{FOLDER}/{PHOTO}

其中{FOLDER}與{PHOTO}分別就是資料夾名稱與檔案名稱，這樣就可以下載原始解析度的照片了。

注意網址結尾不可以帶斜線，會收到 404

而取得不同尺寸的照片的方法是：

[GET] /v1/photos/{FOLDER}/{PHOTO}?size=thumb //預覽圖
[GET] /v1/photos/{FOLDER}/{PHOTO}?size=xs    //1920x1080

最後是照片資訊（非必要）

[GET] /v1/photos/{FOLDER}/{PHOTO}/info

API 還有滿多功能的，包含遙控拍照、關機都做得到，有興趣的可以參考我下面列出的網站繼續深入研究。

另外是其實我自己目前使用官方 Image Sync APP 的體驗還不錯，並沒有網路上所說的斷線或者無法使用的問題。