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

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

fediversesearchのAPIを公開します

www.fediversesearch.comで使用している検索APIを公開します。WebAPIですので、インターネットに接続できる環境であればどなたでもご利用になれます。

URL: https://www.fediversesearch.com/search/
パラメータ: 「?keyword=キーワード」。キーワードには日本語なども使用できます。また、複数キーワードを半角空白で区切って指定するとAND検索になります。OR検索をしたい場合は、「?keyword=キーワード1%20OR%20キーワード2」という風に指定してください。

例: 「https://www.fediversesearch.com/search/?keyword=test.wlw.pw」を呼び出した場合、次のようなjsonデータが返ってきます。

{
 "status":"SUCCESS",
 "data":[
  {"uri":"dolphin.test.wlw.pw","title":"Dolphin","short_description":"","description":"","registrations":false},
  {"uri":"pleroma.test.wlw.pw","title":"Pleroma","short_description":"","description":"Pleroma: An efficient and flexible fediverse server","registrations":false},
  {"uri":"misskey.test.wlw.pw","title":"misskey wlw","short_description":"","description":"","registrations":false}
 ]
}

パラメータを指定しない場合やキーワードを指定しない、キーワードに半角空白だけ入れる場合はdataの中は空で返ってきます。

なお、サービス全体の機能追加などで一時的にアクセスできない場合がありますのでご了承ください。

この機能を利用した例として、TheDeskのPWA版で現在利用を検討されています。TheDeskのサイトでPWAをブラウザで試すときにアカウント登録画面でサーバのURIを入力すると出るサジェスチョン機能で使われています。

thedesk.top

Cutlsさんには、WebAPIを利用した際に一部不具合があること(CORS関連)を指摘していただきました。ありがとうございます。

Cutls (@Cutls@1m.cutls.com) - Cutls