サブスクリプションサービスマニュアル
サービスの紹介
Weibo プラットフォーム サブスクリプション サービスは、アプリケーションの Weibo データ取得効率を向上させます。キーワード、ユーザー、ドメイン名など、アプリケーションによって指定されたサブスクリプション条件に従って、プラットフォームは新しく生成されたデータをリアルタイムでアプリケーションにアクティブにプッシュするため、アプリケーションはリクエスト インターフェイスをポーリングする必要がありません。
サブスクリプション サービスの利点は次のとおりです:
1. 新しいデータをリアルタイムでアプリケーションにプッシュします;
2. ネットワーク オーバーヘッドを節約します;
3. より完全なデータを提供します;
4. アプリケーション アクセス インターフェイスの効率を向上します;
サブスクリプション条件
サブスクライバー:
開発者は最大 10,000 人のユーザーを指定できます。 Weibo を購読する場合、指定したユーザーが Weibo を投稿した場合はプッシュされます。コメントを購読する場合、指定されたユーザーが Weibo に投稿したコメント (指定されたユーザーが投稿したコメントではありません) がプッシュされます。指定しない場合は、プッシュされます。 、そのような制限はありません。
サブスクリプション キーワード:
開発者は最大 20,000 個のキーワードを指定できます。 Weibo を購読する場合、Weibo に指定されたキーワードが含まれている場合はプッシュされます。コメントを購読する場合、コメントに対応する Weibo にこのキーワードが含まれている場合、またはコメント自体にこのキーワードが含まれている場合はプッシュされます。指定されていない場合はプッシュされます。 、そのような制限はありません。
注: 転送された Weibo コンテンツにこのキーワードが含まれていないが、元の Weibo にはこのキーワードが含まれている場合、この場合、プッシュされません
サブスクリプション ドメイン名:
開発者は最大 20 個のドメイン名を指定できます。 Weibo を購読する場合、Weibo 内の短縮リンクに対応する元のリンクが指定されたドメイン名の下にある場合、そのリンクがプッシュされます。コメントを購読する場合、Weibo に対応するコメントに短縮リンクに対応する元のリンクが含まれている場合、プッシュされます。リンクがあり、指定されたドメイン名の下にある場合、プッシュされます。指定しない場合、そのような制限はありません。
サブスクリプション アプリケーション:
開発者は、サブスクリプションを生成するアプリケーションによって生成されたデータのみをプッシュするように指定できます。指定しない場合は、すべてのアプリケーションのデータがプッシュされます。押し込まれるだろう。
購読メディア タイプ:
この条件は、Weibo に購読する場合にのみ指定できます。開発者は、オリジナル、転送、ビデオ、音楽、または画像のタイプを指定できます。次に、指定されたタイプの Weibo をプッシュします。指定されていない場合、そのような制限はありません。コメントを購読する場合、そのようなフィルタリング条件はありません。
サブスクリプション データ タイプ:
開発者は、Weibo またはコメント データをプッシュするように指定できます。指定しない場合、デフォルトで Weibo がプッシュされます。
サブスクリプションの割合:
開発者は、上記のサブスクリプション条件を満たすデータの割合を指定できます。指定しない場合、条件を満たすデータの 1%条件が押し付けられます。
サブスクリプション期間:
開発者はプッシュの開始時刻と終了時刻を指定できます。プッシュ サービスは、指定された開始時刻に準備が完了し、終了時刻に終了します。指定しない場合、開始時刻はデフォルトでサブスクリプションの生成時刻になり、継続的にプッシュされます。プッシュ サービスの準備ができたら、開発者はインターフェイスを呼び出して接続してデータを受信できます。
利用手順
サブスクリプションサービスの利用手順は次のとおりです。
① サブスクリプションの生成:
開発者はオフラインでサブスクリプションサービス申込フォームに入力し、サブスクリプション条件などの情報を入力し、プラットフォーム担当者は申込フォームの情報を基にサブスクリプションを生成します。各アプリケーションは複数のサブスクリプションを持つことができます。サブスクリプション サービスを試す必要がある開発者は、申請フォームに記入することなく、オンラインで申請を送信できます (詳細についてはアクセス ガイドを参照)。
② 購読キーワードとユーザーを設定します:
購読サービス申し込みフォームの「購読キーワード」と「購読ユーザー」で「いいえ」を選択した場合は無視してくださいこのステップです。 [はい] を選択する場合は、キーワード サブスクリプション リストとユーザー サブスクリプション リストが空でないことを確認する必要があります。キーワードとユーザーをサブスクライブします (すでにキーワードとユーザーをサブスクライブしている場合は、この手順を無視できます)、インターフェースを要求します: submit/update_subscribe
このインターフェースに要求される IP は、指定された IP リストである必要があります。サブスクリプション中にシステム内の IP アドレスが指定されていないと、「IP が制限されています」というエラー メッセージが返されます。 subid のみが渡された場合、サブスクリプションのキーワード リストとユーザー リストを含む、サブスクリプションのサブスクリプション情報が返されます。
各キーワードはカンマで区切られており、カンマで区切られたキーワード間には論理「OR」関係があります。
各キーワードの長さは、漢字 36 文字を超えることはできません。
各キーワードは内部的に「AND」と「NOT」ロジックをサポートしています。論理「AND」は「スペース」で区切られます: A B のように、論理「NOT」は「スペース -」で区切られます: A - などB.キーワードの両側に二重引用符がある場合は、キーワードの内容が完全に一致し、論理演算が無効であることを意味します。たとえば、「A B」は論理 A と B を表しません。
各キーワード内の論理演算子で区切られたサブキーワードの合計数は 1,000 を超えることはできません。また、各サブスクリプションの論理演算子の数は 500 を超えることはできません。
インターフェイスが呼び出されるたびにサブスクライブされるキーワードは 20 を超えることはできません。インターフェイスへの各呼び出しに登録するユーザーの数は 50 を超えることはできません。各サブスクリプションのキーワードとユーザーの合計数は 20,000 を超えることはできず、繰り返しのサブスクリプションは許可されません。
Weibo プラットフォームでは、特定のキーワードとユーザーが保護された状態に設定され、保護されたキーワードとユーザーは購読できなくなります。キーワードが保護されると、そのキーワードを含む単語を登録できなくなります。登録されたキーワードとキーワードによってフィルタリングされたデータは、大文字と小文字が区別されず、簡略化または従来型でも区別されません。
③ プッシュ サービスの準備が完了しました:
開発者が申請フォームでプッシュ開始時刻を指定すると、サブスクリプションのプッシュ サービスが準備完了になります。指定された開始時刻 ; 指定されていない場合、プッシュ サービスはサブスクリプションの生成後に準備が整います。
④ アプリケーションの接続とプッシュ開始:
サブスクリプションが生成されたがプッシュ サービスの準備ができていない場合、開発者サブスクリプション管理のプッシュ ステータス背景には「準備中」と表示されます。プッシュ サービスの準備ができている場合は、「準備完了」と表示されます。準備完了状態の場合のみ、アプリケーションはインターフェイスを呼び出して接続してデータを受信できます。そうしないと、インターフェイスの呼び出し時にエラーが報告されます。
呼び出しインターフェイスは次のとおりです:
java 呼び出し。サンプル コードを参照してください。
⑤ アプリケーションはデータを受信します:
接続が成功すると、インターフェイスは Weibo またはコメント データを開発者の接続アドレスにプッシュします。 Weibo またはコメントの完全なデータはそれぞれ json 形式で返され、デフォルトでは UTF-8 エンコードが使用され、\r\n で区切られます。各データ メッセージの最大長は 4096 バイトです。
戻りデータについては、例を参照してください。
⑥ プッシュ終了:
開発者がプッシュ終了時刻を指定しない場合、プッシュは継続されます。終了時刻が指定されている場合は、プッシュが継続されます。指定したプッシュ終了時刻にプッシュされます。プッシュを終了します。これはこのサブスクリプションの有効期限に相当し、再開されません。
使用説明
アプリケーションは、HTTP 長い接続リクエスト インターフェイス /datapush/status または /datapush/comment を通じてデータを受信します。 。どのサブスクリプション データをプッシュするかをプラットフォームに指示するには、パラメーター subid (サブスクリプション ID) を渡す必要があります。リクエストが正しければ、対応するデータ結果が返されます。リクエストが異常な場合は、対応するエラー メッセージが返されます。
サーバーへの負荷を軽減するために、プラットフォームのプッシュ データは 10 分ごとに切断されます。アプリケーションには互換性があり、再 HTTP の長い接続リクエスト インターフェイスが必要であり、ID を取得できる必要があります。最後の切断の値。/datapush/status?subid=xxx&since_id=XXX のように、パラメータ think_id の値として渡します。アプリケーションは切断されたポイントから継続的にデータを取得できます。したがって、アプリケーションはサービス切断時の ID を次のリクエストのパラメータ値として保持する必要があります。
サブスクリプション サービスによってプッシュされたデータはリアルタイムであるため、プラットフォームは 5 分間のデータのみを保持します。5 分を超えて接続が切断された場合、パラメータ think_id はサポートされなくなります。 :Illegal param think_id (since_id が不正で制限時間を超えているため)。 since_id が渡されない場合、プラットフォームは現時点で最初の 50,000 データの中から条件を満たすデータをフィルターし、ユーザーにプッシュします。
アプリケーションが不正な操作やその他の理由に遭遇すると、プラットフォームはサブスクリプションのデータ プッシュ機能を一時停止します。つまり、データはプッシュされなくなります。問題が解決されるまで、プラットフォームはプッシュ機能を再開できます。アプリケーションがインターフェイスを再要求するには、HTTP の長い接続が必要です。
さらに、アプリケーション要求インターフェイスの IP は、サブスクライブ時に指定された IP リスト内の IP アドレスである必要があります。そうでない場合は、次のエラー メッセージが返されます。「IP は制限されています (IP は制限されています)」。
ステータスの説明
開発者管理センターでは、以下の赤いボックスに示すように、サービスのさまざまな表示ステータスを確認できます。 :
サービスのステータスには、準備中、準備完了、有効化、一時停止、終了の 5 つがあります。
1) 準備中:
サブスクリプションは生成されましたが、開発者が指定したプッシュ開始時間に達しておらず、準備中の状態です (開発者はデータを受信するために接続できません)。開発者がプッシュ開始時刻を指定しない場合、サブスクリプションが生成された後、準備状態は存在せず、直接準備完了状態になります。
2) 準備完了:
サブスクリプションが生成され、プッシュ開始時刻が到着しましたが、開発者はデータを受信するために接続されていないため、準備完了状態。または、サブスクリプションが生成され、開発者がプッシュ開始時刻を指定せず、開発者がデータを受信するために接続されていないときも、サービスは準備完了状態になります。
3) オープン済み:
準備完了状態では、開発者が接続してデータを受信し、サービスはオープン状態になります。
4) 一時停止:
アプリケーションに不正な操作がある場合、またはその他の理由により、プラットフォームはサブスクリプションのプッシュ機能とサービスを一時停止します。一時停止状態に変換されます。
5) 終了:
開発者がプッシュ終了時刻を指定しない場合、プッシュは続行されます。終了時刻が指定されている場合、プッシュは続行されます。指定されたプッシュ終了時刻に終了します。これはこのサブスクリプションの有効期限に相当し、再開されません。現時点では、サービスは終了状態です;
