-2
質問内容

リファレンスサイトのGET https://mastodon.example/api/v1/timelines/list/:list_id HTTP/1.1でリストのタイムラインが取得できない原因が知りたい

試したこと

他のwebclient系の処理は成功しているため通信は成功しています。

コメント部のようにURLを様々な形に変更して実験

他のwebclient系の通信処理が正常に行われるためエージェント等の処理は成功しています。

コマンドプロンプトの出力がStatusCodeがOK以外場合が来ているので値を確認しています。

list_idはwebブラウザ上のものと同じため正しいです

参考コードは自分で記述して正常に動作しているのですがこれとまったく同じことをやっているので取得出来ているはずなので取得出来ません。

リファレンス(View list timeline):https://docs.joinmastodon.org/methods/timelines/

コマンドプロンプト
10819
mstdn.jp
list_id=10819&Authorization=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
NotFound
ソースコード


        /*##################################################################################################################
         * リストタイムライン 取得
        ###################################################################################################################*/
        public async Task<List<JsonData.Post>?> getListTimeLine_Asnyc(string listID, string? max_id, string? since_id, string? min_id, string? limit)
        {
            //var response = await client.GetAsync("https://" + instance + "/api/v1/timelines/list/:" + Method_Parameter.GetListTimeLine(listID,token,null, null, null, null).ReadAsStringAsync().Result);
            //var response = await client.GetAsync("https://" + instance + "/api/v1/timelines/list/:list_id?" + Method_Parameter.GetListTimeLine(listID,token,null, null, null, null).ReadAsStringAsync().Result);
            //var response = await client.GetAsync("https://" + instance + "/api/v1/timelines/list/" + Method_Parameter.GetListTimeLine(listID,token,null, null, null, null).ReadAsStringAsync().Result);
            //var response = await client.GetAsync("https://" + instance + "/api/v1/timelines/list/?" + Method_Parameter.GetListTimeLine(listID,token,null, null, null, null).ReadAsStringAsync().Result);
            var response = await client.GetAsync("https://" + instance + "/api/v1/timelines/list/" + Method_Parameter.GetListTimeLine(listID,token,null, null, null, null).ReadAsStringAsync().Result);
            var response = await client.GetAsync("https://" + instance + "/api/v1/timelines/list/:list_id" + Method_Parameter.GetListTimeLine(listID,token,null, null, null, null).ReadAsStringAsync().Result);

            if (response.StatusCode == HttpStatusCode.OK)
            {
                var notice = await response.Content.ReadFromJsonAsync<List<JsonData.Post>>();

                List<JsonData.Post> list = new List<JsonData.Post>();
                foreach (JsonData.Post n in notice)
                {
                   

                    list.Add(n);
                }

                return list;
            }
            else
            {
                Console.WriteLine(listID);
                Console.WriteLine(instance);
                Console.WriteLine(Method_Parameter.GetListTimeLine(listID, token, null, null, null, null).ReadAsStringAsync().Result);
                Console.WriteLine(response.StatusCode);
                return null;
            }

            return null;

        }


        /*##################################################################################################################
         * リストタイムライン 取得
        ###################################################################################################################*/
        static public FormUrlEncodedContent GetListTimeLine(string listID,string token, string? max_id, string? since_id, string? min_id, string? limit)
        {
            var parameter = new Dictionary<string, string>();

            parameter.Add("list_id", listID);
            //parameter.Add(":list_id", listID);
            parameter.Add("Authorization", token);


            if (max_id != null)
            {
                parameter.Add("max_id", max_id);
            }

            if (since_id != null)
            {
                parameter.Add("since_id", since_id);
            }

            if (min_id != null)
            {
                parameter.Add("min_id", min_id);
            }

            if (limit != null)
            {
                parameter.Add("limit", limit);
            }

            return new FormUrlEncodedContent(parameter);
        }
参考コード

        /*##################################################################################################################
         * 通知一覧を取得
        ###################################################################################################################*/
        public async Task<List<Notice>?> getNotics_Asnyc()
        {
            var response = await client.GetAsync("https://" + instance + "/api/v1/notifications?" + Method_Parameter.GetNotics(token,null,null,null,null,null,null).ReadAsStringAsync().Result);
            
            if (response.StatusCode == HttpStatusCode.OK)
            {
                var notice = await response.Content.ReadFromJsonAsync<List<JsonData.Notice>>();

                List<Notice> list = new List<Notice>();
                foreach(JsonData.Notice n in notice)
                {
                    Notice nn = new Notice(n);
                   
                    list.Add(new Notice(n));
                }
                
                return list;
            }
            else
            {
                Console.WriteLine("getList_Async()  " + response.StatusCode);

                return null;
            }

            return null;

        }

4
  • 2
    実現できていること、できていないこと、疑っている部分など、論点を整理してください。「参考コード」が「期待通りに動作するコード」ですか?
    – sayuri
    2022年11月28日 12:43
  • 2
    リファレンスを見ると /api/v1/timelines/list/:10819 というパスを GET するように読めます。Query parameters 欄に list_id も Authorization もありません。
    – int32_t
    2022年11月29日 0:15
  • 1
    通信が出来ていてもAPIとして正しいリクエストを送れていなければ、期待する結果は返ってきません。リクエストの結果 = レスポンスの内容をよく確認してみてください。
    – cubick
    2022年11月29日 1:59
  • int32_t様 それはどういう意味でしょうか?もう少し詳細によろしいでしょうか?以下のよにしたのですがnot found になります var response = await client.GetAsync("https://" + instance + "/api/v1/timelines/list/:"+listID); 2022年11月29日 10:00

2 件の回答 2

4

APIアクセスできるようになるには、リファレンスの内容を理解して、アクセスすべきURLがどのようになるのかを自分で組み立てられるようにならなければなりません。原因は「リファレンスの理解不足」です。ですので、コードをいくら直そうが、正しいURLにはいつまで辿り着けないため、解決することはありません。

MastodonのAPIの使い方はGetting started with the APIに書いていますが、一般的なREST APIを知っている人向けに書かれています。一般的なREST APIとは異なるかも知れない細部(そのほとんどはMastdonが作られたRuby on Rails特有のもの)が述べられています。もし、Ruby on Railsを知らないのであれば、一読しておく必要があります。その上で、API リファレンス側を確認し、どのようなURLでアクセスすべきなのかを考えます。

まず、URLが構成する要素について、きちんと知っているでしょうか?もし、知らないというのであれば、この先を読んでも理解はできません。その場合は、書籍などで勉強し直してください。

URLは大きく分けて次の要素からなります。(これに加えて「ハッシュ」がありますが、今回は扱わないので省略します。)

  • スキーム
  • ホスト(ユーザー情報とポートがついている場合がある)
  • パス
  • クエリ

これを使ってURLを表すと【スキーム】://【ホスト】【パス】?【クエリ】という形です。では、リファレンスではこれらは、どのようになっているでしょうか?GET https://mastodon.example/api/v1/timelines/list/:list_id HTTP/1.1なので

  • スキーム: https
  • ホスト: mastodon.example.com
  • パス: /api/v1/timelines/list/:list_id
  • クエリ: なし?

いいえ違います。

まず、ホストは例では無く実際のサーバーになります。Mastdonは色々なサーバーがあるので、実際に使っているサーバーによって変わると言うことです。ここらへんはわかるかと思いますが、Twitterのような一つのサービスの場合はホストは不変だったりします。

次にパスですが、ここに、このリファレンスがある程度REST APIを知っている人向けに書かれているといえる所があります。パスのところで:list_idというのがありますが、パスに:をそのまま書くことはできません。 もし、REST APIに詳しくなくても、これはそのままパスの文字列にはできないということに気付かなければなりません。では、:list_idは何かというと、パスの中に含まれるパラメーター「パスパラメーター/Path paramaters」というものです。では、どんな値になるのかはすぐしたのPath parametersに書いています。リストのIDが文字列としてそのまま入ると言うことです。どういうことかというと、もし、リストのIDが42の場合は、パスは/api/v1/timelines/list/42になるということです。

最後にクエリですが、GETから始まるところにはクエリはありませんでした。ですが、クエリを付けられないという事ではありません。Query parametersに追加できるクエリがあります。たとえば、limitを30にしたいならlimit=30とクエリを追加できます。

では、リストのIDが42に対して、30個までを取る場合は具体的にどうなるのかを見ていきましょう。ホストは例のままにします。

  • スキーム: https
  • ホスト: mastodon.example.com
  • パス: /api/v1/timelines/list/42
  • クエリ: limit=30

URLは次のようになります。

https://mastodon.example.com/api/v1/timelines/list/42?limit=30

このようなURLへアクセスする必要があります。まずは、URLとなる文字列を生成し、それが想定通りの値になっているかをConsole.WriteLine()等で確認してください。

最後に、ヘッダーに認可トークン(Authorization)が含まれる必要がありますが、他ができていれば、たぶんできているでしょう。


なお、既にC#のライブラリがあるので、自分で組むのは車輪の再発明だし、こちらを組み込んだ方が早いと思います。もし、REST APIの勉強のためというのであれば、Qiita APIとか日本語の解説がついているもののほうが最初はやりやすいと思います。

1
  • 2
    書いている間に質問者が回答して解決したみたいだけど、せっかく書いたので投稿しておきます。
    – raccy
    2022年11月29日 10:22
0
原因

パスパラメータ、クエリパラメータ、ヘッダーがそれぞれ別のものであるとういことを見落としていました。結果リファレンスサイト通り以下のURLをGETすることにより取得出来ました。

 var response = await client.GetAsync("https://" + instance + "/api/v1/timelines/list/"+listID);

この質問に回答するには、ログインする必要があります。

求めていた回答ではありませんか? のタグが付いた他の質問を参照する。