プログラミングなんてわからないんですけど〜

元プログラマによるプライベートでのプログラミング日記。1/3のつもりだけどソフト関連はここがメイン

fediversesearch APIの使用例を紹介します(TheDesk)

Cutls氏が開発している「TheDesk」というデスクトップアプリがあります。このアプリは、Windows/Mac/Linuxのデスクトップで動くマストドン・misskeyなどなどのクライアントアプリです。

thedesk.top
1m.cutls.com

実は、fediversearchを公開した時に「APIあったら使うかも」というお話がありました。

1m.cutls.com

「ありますよ」ということで、試験的にTheDeskのソースに手を入れて色々試したところ、CORS関係でfediversesearch側もいじらないといけないことがわかり、こちら側でも手を入れて最新のソースコードをベースとしたブラウザ版で動作確認が取れました。

popon.pptdn.jp

で、TheDesk 22.2.0がリリースされてそのコードが入ったのでご紹介となりました。

TheDeskでどのようにfediversesearch APIを活用しているかをご紹介します。
TheDeskのアカウント登録画面で、登録したいアカウントのあるサーバのurlの一部を入力するとfediversesearchのsearch APIで取得したデータを基にサーバ名をサジェストしてくれます。
f:id:kaias1jp:20210417143943p:plain
f:id:kaias1jp:20210417143957p:plain

「mstdn」と打つとずらっと並びますね。で、例えば私のサーバの「popon.pptdn.jp」の「popon」を入力するとこうなるわけです。
f:id:kaias1jp:20210417144057p:plain

1つしかサーバが見つからないので、そのサーバをクリックするとwebブラウザが開いてアクセス認証画面が出てきます。
f:id:kaias1jp:20210417144211p:plain

承認すると、コードが表示されるのコピーしてTheDeskの入力欄に貼り付けるとアカウントの登録ができるわけです。

マストドンではこうなのですが、TheDeskとfediversesearchはmisskeyにも対応しているのでmisskeyのサーバをサジェストすることもできます。
f:id:kaias1jp:20210417144431p:plain

misskey.ioの私のアカウントを紐づけようとすると、このような感じで確認の画面がWebブラウザに出ます。
f:id:kaias1jp:20210417144519p:plain

このように、TheDeskでのアカウント登録の補助ができるようになっています。
TheDeskでの使用感を試したい方は、ブラウザ版を使ってみるのが手っ取り早いです。
https://app.thedesk.top/app

これはfediversesearch search APIの使用例の一つです。APIの使用に関しては申請などは今のところ必要ではないので、ご自由にお使いください。一番簡単な「キーワード検索」は以下のように呼び出せます。
https://www.fediversesearch.com/search/?keyword=bike

これはキーワードに「bike」を指定した場合の例です。URLエンコードをかければ日本語文字列での検索もできます。