API経由でプロバイダーのサービスをSMMパネルのカードに紐付ける方法
プロバイダーのカタログとパネルのショーケースを分ける理由
プロバイダーのAPIは通常、技術的なカタログを返します。外部ID、名称、価格、上限、ステータス、注文パラメータなどです。SMMパネルでは、同じ項目が顧客にわかりやすい構造に収まる必要があります。プラットフォーム、プロモーションの種類、地域、リンク形式、オーディエンスの品質、起動速度などです。
外部カタログを加工せずに表示すると、ショーケースに技術的な名称、重複、利用不可の項目が現れます。マッピングによって、仕入れのロジックと顧客向けカードが分離されます。プロバイダーの1つのサービスが、パネル内で必ずしも独立したサービスである必要はありません。
API経由で取得すべきデータ
プロバイダーの元データは、ショーケースの設定とは別に保存してください。外部IDをパネルの内部識別子で置き換えてはいけません。注文の作成、ステータスの取得、キャンセル、エラー解析に必要です。最終同期時刻とAPIの完全なレスポンス、またはそのスナップショットも保存しておくと便利です。
- プロバイダー識別子とサービスの外部ID。
- 名称、説明、外部カテゴリ。
- 仕入れ価格、通貨、計算単位。
- 最小量、最大量、数量の刻み。
- 利用可否ステータス、残量、一時停止のフラグ。
- リンク、ログイン、投稿、コメント、地域に関する要件。
- 手動起動、キャンセル、追加実行、部分実行のフラグ。
自動インポートの欠点は、プロバイダーごとに同じフィールドの呼び方が異なり、不完全なデータを送る場合があることです。サービス名は安定した紐付けには適しません。外部IDを変えずに名称が変更されることがあります。
サービスカタログのリクエストとレスポンスの例
APIの形式はプロバイダーによって異なりますが、ロジックは通常同じです。パネルがアクセスキーとページパラメータを送信し、レスポンスでサービスの配列を受け取ります。たとえば、カーソル付きのカタログリクエストは次のようになります。
GET /api/services?cursor=eyJwYWdlIjoyfQ
APIレスポンスの例:
{ "services": [ { "id": "SP-1042", "name": "Global Followers", "platform": "twitch", "type": "followers", "price": "12.50", "min": 100, "max": 10000, "status": "active" } ], "next_cursor": "eyJwYWdlIjozfQ" }
レスポンスのフィールドをすぐにショーケースのカードへ書き込むべきではありません。まず検証し、プロバイダーのカタログに保存し、内部ルールと照合する必要があります。既成のカードだけで作業する欠点は、インポートが顧客向けの名称、説明、手動で選択したカテゴリを上書きする可能性があることです。
まずパネル内のカテゴリ構造を定義する
インポートの前にパネルのタクソノミーを決めます。最上位は通常プラットフォームを表し、次はアクションです。フォロワー、再生、リアクション、コメント、配信視聴者、その他の形式などです。内部では、地域、オーディエンスの種類、速度、補償条件でサービスを分けられます。
各カテゴリに必須の属性を設定します。再生ではリンクの種類とコンテンツ形式、フォロワーではプラットフォーム、地域、許容されるプロフィールの種類などです。構造が細かすぎる欠点は、カタログの維持が難しくなり、似たサービスが内部的なニュアンスだけで区別されるようになることです。
プロバイダーとショーケースの紐付けを別に保存する
プロバイダーのサービスとパネルのカードの紐付けは、別のテーブルまたはエンティティに保存する必要があります。そこにはプロバイダー、外部ID、内部カード、カテゴリ、価格ルール、ルートの優先度、公開ステータス、最後に成功した検証の日付が必要です。
このスキームにより、カードのURLを変えずに、注文履歴も失わずにプロバイダーを差し替えられます。JSONでのマッピング行の例:
{ "supplier_id": "supplier_a", "external_service_id": "SP-1042", "panel_category": "twitch_followers", "showcase_card_id": "followers_global", "route_priority": 1, "status": "active" }

紐付けはさまざまですが、それぞれについて更新ルールを事前に定義します。
- プロバイダーの1つのサービスに1つのカード。固有のパラメータと注文フォームがある場合。
- 異なるプロバイダーの複数サービスに1つのカード。要件と条件が互換性がある場合。
- プロバイダーの1つのサービスに複数のカード。ショーケースが言語、セグメント、販売方法で分けている場合。
複数のプロバイダーを1つのカードに統合する欠点は、速度、可用性、実際の実行条件が異なる可能性があることです。リンク形式、上限、必須フィールドが異なるルートを統合しないでください。
カタログをページ単位でインポートする
プロバイダーは番号、オフセット、カーソルでカタログをページ単位で返す場合があります。最初のレスポンスにすべてのサービスが含まれるとは限りません。APIがカーソル、続きへのリンク、その他のデータ存在の明示的な兆候を返す限り、次のページをリクエストします。
カーソルページネーションでの処理は次のとおりです。パネルがページを受け取り、すべてのサービスを保存し、現在のサイクルで見つかったものとして記録し、その後でのみ次のカーソルへ進みます。next_cursorフィールドがなければ、走査は完了とみなされます。
- 現在の同期サイクルの識別子を作成します。
- 最初のページをリクエストし、取得したサービスを保存します。
- 各サービスについて、last_seen_syncフィールドをサイクル識別子で更新します。
- 次のリクエストを実行する前に、次のページのカーソルを保存します。
- すべてのページの走査が成功したら、カタログを現在のサイクルと比較します。
ページを順次読み込む欠点は、完全なインポートに時間がかかる場合があることです。並列リクエストは処理を速めますが、APIの制限に達したり、カタログの異なる状態のページを取得したりするリスクが高まります。
再同期時に重複を作成しない
既存のサービスを検索するには、複合キーを使用します。プロバイダー識別子とサービスの外部IDです。再インポートのたびに、まずこのペアでレコードを検索し、次に技術フィールドを更新します。新しいレコードは、そのキーが存在しない場合にのみ作成します。
重複排除に名称、価格、カテゴリを使用しないでください。2つの異なるサービスでこれらの値が一致する場合があり、プロバイダーは外部IDを変えずに項目名を変更する場合があります。ショーケースとの紐付けにも一意の制御が必要です。同じルートがタスクの再実行後に2回現れてはいけません。
データベースレベルで一意性を制限すると便利です。プロバイダーのカタログにはsupplier_id + external_service_id、マッピングにはsupplier_id + external_service_id + showcase_card_idです。厳格な制限の欠点は、古い紐付けにエラーがある場合、その上に新しいレコードを作成するのではなく、明示的に修正する必要があることです。
削除されたサービスと消えたサービスを見つける方法
サービスが消えたとみなせるのは、すべてのページの走査が完全に成功した後だけです。同期がエラー、リクエスト制限、APIの利用不可で停止した場合、すでに読み込まれたカタログ部分にない項目を削除済みとしてマークしてはいけません。
インポート完了後、このプロバイダーのサービスの中でlast_seen_syncが現在のサイクル識別子と等しくないものを探します。それらには「見つからない」または「アーカイブ済み」のステータスを割り当て、新しい注文から切り離し、検証に送ります。外部ID、変更履歴、注文との紐付けは保存します。
消えたサービスは削除するのではなくアーカイブする必要があります。プロバイダーは後でそれをカタログに戻したり、レスポンスのフィルタを変更したり、項目を一時的に非表示にしたりする場合があります。同じ外部IDが再び現れた場合、アーカイブされた紐付けは次のインポートで復元できます。
サービスの外部IDが変更された場合の対処
プロバイダーが古いものの代わりに新しいサービスを作成した場合、新しい外部IDを自動的に以前のものの継続とみなすことはできません。名称と価格が同じでも、注文要件、地域、オーディエンスの種類、補償条件が変わっている可能性があります。
古い紐付けはアーカイブに移し、ルートを販売から外し、古い注文のために保存します。新しいサービスは別のレコードとしてインポートします。その後、技術パラメータが完全に互換性がある場合、手動または安全なルールで新しいマッピングを作成します。
名称による自動照合は作業を速められますが、その欠点は不適切な条件の別のサービスへ注文を送るリスクです。IDの変更には、ルートの静かな置き換えではなく「要確認」ステータスを使用する方がよいです。
安定した技術フィールドでマッピングを設定する
サービスの自動振り分けは、フィールドのセットに基づいて構築する方がよいです。プラットフォーム、サービスの種類、地域、リンク形式、最小量、追加パラメータ、ステータスなどです。たとえば、APIが互換性のあるプラットフォーム、プロモーションの種類、国の値を返す場合、サービスは地域別の再生カテゴリに該当する可能性があります。
プロバイダーがコメント、プロフィールリスト、手動起動を要求する場合、標準の注文フォームでルートを公開しないでください。必要なフィールドを持つ別のカードを使用するか、統合の改修までサービスを非表示のままにします。
名称は補助的な属性としてのみ使用できます。このようなルールの欠点は、プロバイダーが表現を変更したり、略語を追加したり、別の表記を使用したりする可能性があることです。重要なルートは外部IDと検証可能なレスポンスパラメータに紐付けてください。
APIデータとカード設定を分ける
インポートはショーケースのカードを完全に上書きしてはいけません。仕入れ価格、上限、可用性、技術パラメータは通常プロバイダーから更新されます。顧客向けの名称、説明、表示、表示順、マークアップルールはパネルの内部設定のままです。
各フィールドに信頼できる情報源を割り当てます。たとえば、最小量はAPIから取得し、顧客向け名称はパネルから取得し、ショーケースの価格は仕入れコストに基づく内部ルールで計算します。このような分離がなければ、同期によって手動で編集した説明が消えたり、外部名称に基づいてカテゴリが変更されたりする可能性があります。
価格とパラメータの変更を確認する
プロバイダーが価格を変更した場合、カードのルールでショーケースの価格を再計算し、通貨、手数料、許容マージンを確認します。価格がない場合、通貨が不明な場合、条件が著しく変更された場合、ルートを検証ステータスに移す方がよいです。
最小量、最大量、数量の刻みが変更された場合、注文フォームを更新します。フォームが新しい制限をサポートしていない場合、ルートを販売から外します。そうでなければ、顧客が注文し、プロバイダーが送信後に拒否することになります。
リンク形式、必須フィールド、サービスの種類、起動方法が変更された場合、手動検証まで新しい注文をブロックします。厳格なブロックの欠点は、一部のカードが一時的にショーケースから消えることですが、互換性のない注文を受け付けるより安全です。
APIエラーとリクエスト制限を処理する
1つのリクエストのエラーでカタログ全体を自動的に無効にしてはいけません。認証エラー、不正なリクエスト、一時的な利用不可、リクエスト頻度の制限を分けます。各グループに個別のシナリオが必要です。
- 認証エラーの場合、このプロバイダーへの新しい注文を停止し、アクセスを確認します。
- リクエスト形式エラーの場合、APIレスポンスを保存し、無限の再試行なしで統合を修正します。
- 一時的なエラーの場合、増加する間隔でリクエストを再試行します。
- 頻度制限の場合、現在のカーソルを保存し、タスクを再実行に回します。
延期された同期が成功裏に完了するまで、サービスを消えたものとしてマークしないでください。積極的な再試行の欠点は、リクエスト制限をより早く使い果たし、カタログをより長期間古いままにする可能性があることです。
アクティブな注文のためにルートを保存する
サービスのステータスと注文のステータスは別のエンティティです。サービスは新しい顧客向けのカタログから消えても、それによる古い注文はまだ実行中の場合があります。カードやルートのアーカイブは、すでに作成された注文のステータス取得を停止してはいけません。
各注文について、サービスの外部ID、注文の外部ID、送信したパラメータ、起動時の仕入れコスト、ステータス履歴を保存します。プロバイダーが部分実行、キャンセル、エラーを報告した場合、パネルのルールに従って処理します。返金、補償、追加実行、手動検証などです。
注文パラメータのスナップショットを保存する欠点は、より多くの容量と慎重なデータスキーマが必要になることです。このようなスナップショットがなければ、プロバイダーが後でサービスを変更した場合、注文がどのような条件で送信されたかを特定できません。
カード公開前にマッピングをテストする
設定後、完全なパスを確認します。パネルでの注文作成、ルートの選択、プロバイダーへの送信、外部IDの保存、ステータスの取得、キャンセル、部分実行の処理です。異なる上限、リンク、必須フィールドを持つサービスのグループをテストします。
別途、再インポート、価格変更、完全な走査成功後のサービスの消失、ページネーション途中のエラー、リクエスト頻度制限をシミュレートします。これにより、不完全なカタログ読み込みのためにパネルが稼働中のルートをアーカイブしていないかがわかります。
手動サービスとコメント付きの項目には特に注意してください。その欠点は、パネルの標準フォームがプロバイダーの期待するすべてのデータを送信しない場合が多いことです。それらには別の注文テンプレート、またはAPI統合の改修までの非表示ステータスが必要です。
Last Articles
デザインと機能の変更点 より速く、より快適にご利用いただけるようサイトを更新しました。主な変更点は、インターフェース、アカウント、注文管理に関わるものです。 データベースへのクエリを最適化したことで、ページの読み込みが平均で約3分の1高速化しました。ナビゲーションメニューはヘッダーから左側のサイ..
Good afternoon, I've collected all the news during this time.: 1. The main news is that prices for twitch viewers have been greatly reduced, while Tw..
1. 視聴者全員が15%オフになるプロモーションコード「December2025」をご利用ください2. 1月1日まで、当社の設定ツールと最もお手頃な視聴者カテゴリーの基本価格を25%値下げしました3. 当社のチャンネルで3つの抽選が開催中です! - 当社の購入ランキングでトップ100に入る..
Twitchサービスは次のとおりです 安定して働くこと、従って私達は分隊、転売者に協力して準備ができています, サービスの所有者、ボットの所有者、および他の多く。個々の用語は、Telegram@Tikey_Kの管理者と議論することができます..
私たちは Twitch viewerサービスを完全に更新しました。 安定して働くこと。 私たちは視聴者のために高品質のIPアドレスのみを使用しています。ニュアンスは最大150人の視聴者のための注文にあります。 合計視聴者数が200に達すると、それらはドロップされます。のために たとえば、..
Hello everyone! Today, we are announcing a new feature—"Twitch Viewer Configurator". Now, you can customize any plan for your Twitch channel. Choo..
Greetings, I have compiled a guide for streamers, which will be very relevant at the moment. Now YouTube and twitch have disabled monetization from vi..
We have finally developed the APINow it will be more convenient for our partner sites to work with us.To update the maximum tariffs for YouTube, an up..
パートナーシップ サービスと紹介プログラムが大変好評だったため、協力テーブルを作成しました。その本質は非常にシンプルです。ライブ視聴者が増えれば、私たちからの広告も増えます。プログラムの規約をダウンロードまたは表示するパートナーセットをダウンロードするには(イントロ+ロゴ)ストリーマーは、ストリーム..
ストリーマー向けサービス
VK Video Live

Dlive

Shopee

Bigo
コンテンツクリエイター向けサービス







