Support
Mapeamento de serviços do fornecedor com categorias do painel SMM via API

Como vincular serviços do fornecedor aos cards do painel SMM via API

Por que separar o catálogo do fornecedor da vitrine do painel

A API do fornecedor geralmente retorna um catálogo técnico: ID externo, nome, preço, limites, status e parâmetros do pedido. No painel SMM, a mesma posição deve entrar em uma estrutura compreensível para o cliente: plataforma, tipo de promoção, geografia, formato do link, qualidade da audiência ou velocidade de início.

Se você exibir o catálogo externo sem tratamento, a vitrine terá nomes técnicos, duplicatas e posições indisponíveis. O mapeamento separa a lógica de compra do card do cliente. Um serviço do fornecedor não precisa ser necessariamente um serviço separado no painel.

Quais dados precisam ser obtidos via API

Armazene os dados originais do fornecedor separadamente das configurações da vitrine. O ID externo não pode ser substituído pelo identificador interno do painel: ele é necessário para criar o pedido, obter o status, cancelar e analisar erros. Também é útil armazenar o horário da última sincronização e a resposta completa da API ou um snapshot dela.

  • Identificador do fornecedor e ID externo do serviço.
  • Nome, descrição e categoria externa.
  • Preço de compra, moeda e unidade de cálculo.
  • Volume mínimo, máximo e passo de quantidade.
  • Status de disponibilidade, saldo e indicador de parada temporária.
  • Requisitos de link, login, publicação, comentário e geografia.
  • Indicadores de início manual, cancelamento, reinício e execução parcial.

A desvantagem da importação automática é que os fornecedores nomeiam os mesmos campos de formas diferentes e às vezes enviam dados incompletos. O nome do serviço não serve para uma vinculação estável: ele pode ser alterado sem mudança do ID externo.

Exemplo de requisição e resposta do catálogo de serviços

O formato da API depende do fornecedor, mas a lógica costuma ser a mesma: o painel envia a chave de acesso e os parâmetros da página, e em resposta recebe um array de serviços. Por exemplo, uma requisição de catálogo com cursor pode ser assim:

GET /api/services?cursor=eyJwYWdlIjoyfQ

Resposta condicional da API:

{ "services": [ { "id": "SP-1042", "name": "Global Followers", "platform": "twitch", "type": "followers", "price": "12.50", "min": 100, "max": 10000, "status": "active" } ], "next_cursor": "eyJwYWdlIjozfQ" }

Os campos da resposta não devem ser gravados diretamente no card da vitrine. Primeiro é preciso validá-los, armazená-los no catálogo do fornecedor e mapeá-los para as regras internas. A desvantagem de trabalhar apenas com o card pronto é que a importação pode sobrescrever o nome do cliente, a descrição ou a categoria escolhida manualmente.

Primeiro defina a estrutura de categorias no painel

Antes da importação, defina a taxonomia do painel. O nível superior geralmente descreve a plataforma, o seguinte — a ação: seguidores, visualizações, reações, comentários, espectadores da transmissão ou outro formato. Dentro dela, é possível dividir os serviços por geografia, tipo de audiência, velocidade e condições de compensação.

Para cada categoria, defina os atributos obrigatórios. Para visualizações, pode ser o tipo de link e o formato do conteúdo; para seguidores — a plataforma, a geografia e o tipo de perfil permitido. A desvantagem de uma estrutura muito detalhada é que o catálogo se torna mais difícil de manter, e serviços semelhantes passam a diferir apenas por nuances internas.

Armazene as vinculações do fornecedor e da vitrine separadamente

A vinculação entre o serviço do fornecedor e o card do painel deve ser armazenada em uma tabela ou entidade separada. Nela são necessários o fornecedor, o ID externo, o card interno, a categoria, a regra de preço, a prioridade da rota, o status de publicação e a data da última verificação bem-sucedida.

Esse esquema permite substituir o fornecedor sem mudar a URL do card e sem perder o histórico de pedidos. Exemplo de linha de mapeamento em JSON:

{ "supplier_id": "supplier_a", "external_service_id": "SP-1042", "panel_category": "twitch_followers", "showcase_card_id": "followers_global", "route_priority": 1, "status": "active" }

Схема связи ID услуги поставщика с категорией SMM-панели и карточкой витрины

As vinculações podem ser diferentes, mas para cada uma defina antecipadamente a regra de atualização.

  • Um serviço do fornecedor — um card, se ele tiver parâmetros e formulário de pedido exclusivos.
  • Vários serviços de fornecedores diferentes — um card, se forem compatíveis em requisitos e condições.
  • Um serviço do fornecedor — vários cards, se a vitrine o separa por idioma, segmento ou forma de venda.

A união de vários fornecedores em um único card tem uma desvantagem: a velocidade, a disponibilidade e as condições reais de execução podem variar. Não una rotas com formatos de link, limites ou campos obrigatórios diferentes.

Importe o catálogo página por página

O fornecedor pode entregar o catálogo em páginas por número, offset ou cursor. A primeira resposta não contém necessariamente todos os serviços. Solicite a próxima página enquanto a API retornar um cursor, um link de continuação ou outro indicador explícito de que há dados.

Na paginação por cursor, o processamento funciona assim: o painel recebe a página, salva todos os serviços, registra-os como encontrados no ciclo atual e só então passa para o próximo cursor. Se o campo next_cursor estiver ausente, a varredura é considerada concluída.

  1. Crie um identificador para o ciclo de sincronização atual.
  2. Solicite a primeira página e salve os serviços recebidos.
  3. Para cada serviço, atualize o campo last_seen_sync com o identificador do ciclo.
  4. Salve o cursor da próxima página antes de executar a próxima requisição.
  5. Após varrer todas as páginas com sucesso, compare o catálogo com o ciclo atual.

A desvantagem do carregamento sequencial de páginas é que a importação completa pode demorar mais. Requisições paralelas aceleram o processo, mas aumentam o risco de esbarrar no limite da API ou de obter páginas em estados diferentes do catálogo.

Não crie duplicatas na ressincronização

Para localizar um serviço existente, use uma chave composta: o identificador do fornecedor e o ID externo do serviço. A cada nova importação, primeiro procure o registro por esse par e depois atualize os campos técnicos. Crie um novo registro apenas quando essa chave não existir.

Não use o nome, o preço ou a categoria para deduplicação. Dois serviços diferentes podem ter esses valores iguais, e o fornecedor pode renomear a posição sem alterar o ID externo. Para as vinculações com a vitrine também é necessário um controle exclusivo: a mesma rota não deve aparecer duas vezes após a reexecução da tarefa.

É útil restringir a unicidade no nível do banco de dados: supplier_id + external_service_id para o catálogo do fornecedor e supplier_id + external_service_id + showcase_card_id para o mapeamento. A desvantagem da restrição rígida é que, em caso de erro em uma vinculação antiga, ela terá de ser corrigida explicitamente, em vez de criar um novo registro por cima dela.

Como encontrar serviços removidos e desaparecidos

Um serviço só pode ser considerado desaparecido após uma varredura totalmente bem-sucedida de todas as páginas. Se a sincronização parou por erro, limite de requisições ou indisponibilidade da API, as posições ausentes na parte já carregada do catálogo não podem ser marcadas como removidas.

Após a importação concluída, encontre os serviços desse fornecedor cujo last_seen_sync não é igual ao identificador do ciclo atual. Eles recebem o status “não encontrado” ou “arquivado”, são desativados para novos pedidos e enviados para verificação. O ID externo, o histórico de alterações e as vinculações com pedidos são preservados.

Um serviço que desapareceu deve ser arquivado, não excluído. O fornecedor pode devolvê-lo ao catálogo mais tarde, alterar o filtro da resposta ou ocultar temporariamente a posição. A vinculação arquivada pode ser restaurada na próxima importação, se o mesmo ID externo aparecer novamente.

O que fazer quando o ID externo do serviço muda

Se o fornecedor criou um novo serviço no lugar do antigo, o novo ID externo não pode ser automaticamente considerado uma continuação do anterior. Mesmo com nome e preço iguais, a posição pode ter requisitos de pedido, geografia, tipo de audiência ou condições de compensação alterados.

Mova a vinculação antiga para o arquivo, retire a rota da venda e preserve-a para os pedidos antigos. Importe o novo serviço como um registro separado. Depois, crie um novo mapeamento manualmente ou por uma regra segura, se os parâmetros técnicos forem totalmente compatíveis.

O mapeamento automático por nome pode acelerar o trabalho, mas sua desvantagem é o risco de enviar o pedido para outro serviço com condições inadequadas. Para a mudança de ID, é melhor usar o status “requer verificação” em vez de substituir a rota silenciosamente.

Configure o mapeamento por campos técnicos estáveis

A distribuição automática de serviços deve ser construída preferencialmente com base em um conjunto de campos: plataforma, tipo de serviço, geografia, formato do link, volume mínimo, parâmetros adicionais e status. Por exemplo, um serviço pode entrar na categoria de visualizações por geografia se a API retornar valores compatíveis de plataforma, tipo de promoção e país.

Se o fornecedor exigir comentário, lista de perfis ou início manual, não publique a rota no formulário de pedido padrão. Use um card separado com os campos necessários ou mantenha o serviço oculto até a integração ser aprimorada.

O nome pode ser usado apenas como atributo adicional. A desvantagem dessa regra é que o fornecedor pode alterar a formulação, adicionar uma abreviação ou usar outra grafia. Vincule as rotas críticas ao ID externo e aos parâmetros verificáveis da resposta.

Separe os dados da API e as configurações do card

A importação não deve sobrescrever completamente o card da vitrine. O preço de compra, os limites, a disponibilidade e os parâmetros técnicos geralmente são atualizados a partir do fornecedor. O nome para o cliente, a descrição, a visibilidade, a ordem de exibição e as regras de markup permanecem como configurações internas do painel.

Para cada campo, defina a fonte da verdade. Por exemplo, o volume mínimo vem da API, o nome do cliente vem do painel, e o preço da vitrine é calculado por uma regra interna com base no custo de compra. Sem essa separação, a sincronização pode apagar uma descrição editada manualmente ou alterar a categoria com base no nome externo.

Verifique alterações de preço e parâmetros

Se o fornecedor alterou o preço, recalcule o preço da vitrine pela regra do card e verifique a moeda, as comissões e a margem permitida. Em caso de preço ausente, moeda desconhecida ou mudança significativa nas condições, é melhor mover a rota para o status de verificação.

Ao alterar o mínimo, o máximo ou o passo de quantidade, atualize o formulário de pedido. Se o formulário não suportar as novas restrições, retire a rota da venda. Caso contrário, o cliente fará um pedido que o fornecedor rejeitará após o envio.

Se o formato do link, o campo obrigatório, o tipo de serviço ou a forma de início mudaram, bloqueie novos pedidos até a verificação manual. A desvantagem do bloqueio rígido é que parte dos cards desaparecerá temporariamente da vitrine, mas isso é mais seguro do que aceitar pedidos incompatíveis.

Trate erros de API e limites de requisições

O erro de uma requisição não deve desativar automaticamente todo o catálogo. Separe erros de autorização, requisição inválida, indisponibilidade temporária e limite de frequência de requisições. Cada grupo precisa de um cenário próprio.

  • Em caso de erro de autorização, interrompa novos pedidos para esse fornecedor e verifique o acesso.
  • Em caso de erro de formato da requisição, salve a resposta da API e corrija a integração sem repetições infinitas.
  • Em caso de erro temporário, repita a requisição com uma pausa crescente.
  • Em caso de limite de frequência, salve o cursor atual e reagende a tarefa.

Não marque serviços como desaparecidos enquanto a sincronização adiada não for concluída com sucesso. A desvantagem das repetições agressivas é que você pode esgotar o limite de requisições mais rápido e deixar o catálogo desatualizado por mais tempo.

Preserve as rotas para pedidos ativos

O status do serviço e o status do pedido são entidades diferentes. O serviço pode desaparecer do catálogo para novos clientes, mas os pedidos antigos por ele ainda estão sendo executados. O arquivamento do card ou da rota não deve interromper a consulta de status dos pedidos já criados.

Para cada pedido, armazene o ID externo do serviço, o ID externo do pedido, os parâmetros enviados, o custo de compra no momento do início e o histórico de status. Se o fornecedor informar execução parcial, cancelamento ou erro, trate a situação conforme as regras do painel: reembolso, compensação, reinício ou verificação manual.

A desvantagem de armazenar um snapshot dos parâmetros do pedido é que será necessário mais espaço e um esquema de dados cuidadoso. Sem esse snapshot, é impossível determinar em quais condições o pedido foi enviado, caso o fornecedor altere o serviço posteriormente.

Teste o mapeamento antes de publicar os cards

Após a configuração, verifique o caminho completo: criação do pedido no painel, seleção da rota, envio ao fornecedor, armazenamento do ID externo, recebimento do status, cancelamento e tratamento de execução parcial. Teste grupos de serviços com limites, links e campos obrigatórios diferentes.

Simule separadamente a reimportação, a alteração de preço, o desaparecimento de um serviço após uma varredura completa bem-sucedida, um erro no meio da paginação e o limite de frequência de requisições. Isso mostrará se o painel está arquivando rotas ativas devido a um carregamento incompleto do catálogo.

Preste atenção especial aos serviços manuais e às posições com comentários. A desvantagem deles é que o formulário padrão do painel muitas vezes não transmite todos os dados que o fornecedor espera. Para eles, é necessário um template de pedido separado ou um status oculto até o aprimoramento da integração via API.

Last Articles

Novo design do site

O que mudou no design e na funcionalidade Atualizamos o site para que trabalhar com ele seja mais rápido e prático. As principais mudanças envolvem a..

15/08/2026 Novidade

News SP

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..

08/04/2026 Atualização

Reunimos para você todas as promoções e sorteios atuais até 01.01.2026

1. Use o código promocional "December2025" para 15% de desconto para todos os nossos espectadores2. Reduzimos até 1º de janeiro os preços básicos do n..

26/12/2025 Encerrada

Cooperação com esquadrões e revendedores

Os Serviços Twitch são trabalhando estavelmente, assim que nós estamos prontos para cooperar com os esquadrões, revendedores, proprietários de ser..

22/10/2025 Para parceiros

Os espectadores do Twitch são estáveis, mas existem algumas nuances.

Nós atualizamos completamente nossos serviços de visualizador do Twitch, e eles estão agora trabalho estável. Usamos apenas endereços IP de alta q..

22/10/2025 Atualização

Twitch Viewer Configurator

Hello everyone! Today, we are announcing a new feature—"Twitch Viewer Configurator". Now, you can customize any plan for your Twitch channel. Choo..

15/06/2025 Novidade

If YouTube is blocked, where to stream now?

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..

16/03/2022 Importante

API SP

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..

02/09/2021 Para parceiros

PARCEIROS E INDICAÇÕES: NOVOS TERMOS!

Devido à enorme popularidade dos serviços de parceria e programa de indicação, fizemos uma tabela de cooperação. A essência é muito simples: mais públ..

12/08/2020 Para parceiros

Painel de controle de espectadores [Twitch | Kick | YouTube | VK Video Live]

Crie seu próprio plano personalizado
Recarga de saldo, pedido em um clique, descontos e bônus estão disponíveis apenas para usuários cadastrados. Cadastrar-se.
Se você não encontrou o serviço certo ou achou mais barato, escreva para nosso suporte no Telegram ou no chat, e resolveremos qualquer questão.

 

Nossos Serviços para Streamers

 

Nossos Serviços para Criadores de Conteúdo

 

Novo

Bot do Telegram @BOT_SP_RU_BOT

Peça ou repita pedidos em um minuto, saldo e status dos pedidos — direto no Telegram

Repetir pedidoStatus dos pedidosRecarga de saldoCódigos promocionais