Support
Mappatura dei servizi del fornitore con le categorie del pannello SMM tramite API

Come collegare i servizi del fornitore alle schede del pannello SMM tramite API

Perché separare il catalogo del fornitore dalla vetrina del pannello

L'API del fornitore di solito restituisce un catalogo tecnico: ID esterno, nome, prezzo, limiti, stato e parametri dell'ordine. Nel pannello SMM la stessa posizione deve inserirsi in una struttura chiara per il cliente: piattaforma, tipo di promozione, geografia, formato del link, qualità del pubblico o velocità di avvio.

Se si pubblica il catalogo esterno senza elaborarlo, nella vetrina compariranno nomi tecnici, duplicati e posizioni non disponibili. La mappatura separa la logica di acquisto dalla scheda cliente. Un servizio del fornitore non deve necessariamente essere un servizio separato nel pannello.

Quali dati è necessario ricevere tramite API

Conservate i dati originali del fornitore separatamente dalle impostazioni della vetrina. L'ID esterno non può essere sostituito con l'identificatore interno del pannello: serve per creare l'ordine, ottenere lo stato, annullare e analizzare gli errori. È utile anche memorizzare l'ora dell'ultima sincronizzazione e la risposta API completa o una sua istantanea.

  • Identificatore del fornitore e ID esterno del servizio.
  • Nome, descrizione e categoria esterna.
  • Prezzo di acquisto, valuta e unità di calcolo.
  • Volume minimo, massimo e passo della quantità.
  • Stato di disponibilità, residuo e indicatore di sospensione temporanea.
  • Requisiti per link, login, pubblicazione, commento e geografia.
  • Indicatori di avvio manuale, annullamento, riavvio e completamento parziale.

Il limite dell'importazione automatica è che i fornitori chiamano gli stessi campi in modi diversi e a volte trasmettono dati incompleti. Il nome del servizio non è adatto per un collegamento stabile: può essere modificato senza cambiare l'ID esterno.

Esempio di richiesta e risposta del catalogo servizi

Il formato dell'API dipende dal fornitore, ma la logica è di solito la stessa: il pannello invia la chiave di accesso e i parametri della pagina, e in risposta riceve un array di servizi. Ad esempio, una richiesta del catalogo con cursore può essere così:

GET /api/services?cursor=eyJwYWdlIjoyfQ

Risposta API condizionale:

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

I campi della risposta non vanno scritti subito nella scheda della vetrina. Prima devono essere verificati, salvati nel catalogo del fornitore e mappati con le regole interne. Il limite di lavorare solo con la scheda già pronta è che l'importazione può sovrascrivere il nome cliente, la descrizione o la categoria scelta manualmente.

Prima definite la struttura delle categorie nel pannello

Prima dell'importazione definite la tassonomia del pannello. Il livello superiore di solito descrive la piattaforma, quello successivo l'azione: follower, visualizzazioni, reazioni, commenti, spettatori della diretta o altro formato. All'interno si possono dividere i servizi per geografia, tipo di pubblico, velocità e condizioni di compensazione.

Per ogni categoria definite i criteri obbligatori. Per le visualizzazioni può essere il tipo di link e il formato del contenuto, per i follower la piattaforma, la geografia e il tipo di profilo ammesso. Il limite di una struttura troppo dettagliata è che il catalogo diventa più difficile da mantenere e servizi simili iniziano a differenziarsi solo per sfumature interne.

Conservate separatamente i collegamenti tra fornitore e vetrina

Il collegamento tra il servizio del fornitore e la scheda del pannello deve essere memorizzato in una tabella o entità separata. Servono fornitore, ID esterno, scheda interna, categoria, regola di prezzo, priorità del percorso, stato di pubblicazione e data dell'ultima verifica riuscita.

Questo schema permette di sostituire il fornitore senza cambiare l'URL della scheda e senza perdere la cronologia degli ordini. Esempio di riga di mappatura in JSON:

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

Schema del collegamento tra l'ID del servizio del fornitore, la categoria del pannello SMM e la scheda della vetrina

I collegamenti possono essere diversi, ma per ciascuno definite in anticipo la regola di aggiornamento.

  • Un servizio del fornitore — una scheda, se ha parametri e modulo d'ordine unici.
  • Più servizi di fornitori diversi — una scheda, se sono compatibili per requisiti e condizioni.
  • Un servizio del fornitore — più schede, se la vetrina lo suddivide per lingua, segmento o modalità di vendita.

L'unione di più fornitori in una scheda ha un limite: velocità, disponibilità e condizioni effettive di esecuzione possono differire. Non unite percorsi con formati di link, limiti o campi obbligatori diversi.

Importate il catalogo pagina per pagina

Il fornitore può restituire il catalogo a pagine tramite numero, offset o cursore. La prima risposta non contiene necessariamente tutti i servizi. Richiedete la pagina successiva finché l'API trasmette un cursore, un link di continuazione o un altro indicatore esplicito della presenza di dati.

Con la paginazione a cursore l'elaborazione funziona così: il pannello riceve la pagina, salva tutti i servizi, li registra come trovati nel ciclo corrente e solo dopo passa al cursore successivo. Se il campo next_cursor è assente, l'iterazione è considerata completata.

  1. Create un identificatore del ciclo di sincronizzazione corrente.
  2. Richiedete la prima pagina e salvate i servizi ricevuti.
  3. Per ogni servizio aggiornate il campo last_seen_sync con l'identificatore del ciclo.
  4. Salvate il cursore della pagina successiva prima di eseguire la richiesta seguente.
  5. Dopo aver completato con successo tutte le pagine confrontate il catalogo con il ciclo corrente.

Il limite del caricamento sequenziale delle pagine è che l'importazione completa può richiedere più tempo. Le richieste parallele accelerano il processo, ma aumentano il rischio di incappare nel limite dell'API o di ottenere pagine in stati diversi del catalogo.

Non create duplicati durante la risincronizzazione

Per cercare un servizio esistente usate una chiave composta: identificatore del fornitore e ID esterno del servizio. A ogni nuova importazione cercate prima il record tramite questa coppia, poi aggiornate i campi tecnici. Create un nuovo record solo in assenza di tale chiave.

Non usate nome, prezzo o categoria per la deduplicazione. Due servizi diversi possono avere questi valori uguali, e il fornitore può rinominare la posizione senza cambiare l'ID esterno. Anche per i collegamenti con la vetrina serve un controllo di unicità: lo stesso percorso non deve comparire due volte dopo il riavvio dell'attività.

È utile limitare l'unicità a livello di database: supplier_id + external_service_id per il catalogo del fornitore e supplier_id + external_service_id + showcase_card_id per la mappatura. Il limite di un vincolo rigido è che in caso di errore in un vecchio collegamento bisognerà correggerlo esplicitamente, invece di creare un nuovo record sopra di esso.

Come individuare i servizi rimossi e scomparsi

Un servizio può essere considerato scomparso solo dopo aver completato con successo l'iterazione di tutte le pagine. Se la sincronizzazione si è fermata per un errore, un limite di richieste o l'indisponibilità dell'API, le posizioni assenti nella parte già caricata del catalogo non possono essere contrassegnate come rimosse.

Dopo l'importazione completata trovate i servizi di questo fornitore il cui last_seen_sync non è uguale all'identificatore del ciclo corrente. A essi viene assegnato lo stato «non trovato» o «archiviato», vengono disattivati dai nuovi ordini e inviati alla verifica. L'ID esterno, la cronologia delle modifiche e i collegamenti con gli ordini vengono conservati.

Un servizio scomparso va archiviato, non eliminato. Il fornitore può reinserirlo nel catalogo in seguito, modificare il filtro della risposta o nascondere temporaneamente la posizione. Il collegamento archiviato può essere ripristinato alla successiva importazione, se lo stesso ID esterno è ricomparso.

Cosa fare quando cambia l'ID esterno del servizio

Se il fornitore ha creato un nuovo servizio al posto del vecchio, il nuovo ID esterno non può essere considerato automaticamente una continuazione del precedente. Anche con nome e prezzo identici, la posizione può aver cambiato requisiti dell'ordine, geografia, tipo di pubblico o condizioni di compensazione.

Spostate il vecchio collegamento in archivio, togliete il percorso dalla vendita e conservatelo per i vecchi ordini. Importate il nuovo servizio come record separato. Poi create una nuova mappatura manualmente o secondo una regola sicura, se i parametri tecnici sono completamente compatibili.

La corrispondenza automatica per nome può accelerare il lavoro, ma il suo limite è il rischio di inviare l'ordine a un altro servizio con condizioni inadatte. Per il cambio di ID è meglio usare lo stato «richiede verifica» invece di una sostituzione silenziosa del percorso.

Configurate la mappatura su campi tecnici stabili

L'assegnazione automatica dei servizi va costruita preferibilmente su un insieme di campi: piattaforma, tipo di servizio, geografia, formato del link, volume minimo, parametri aggiuntivi e stato. Ad esempio, un servizio può rientrare nella categoria visualizzazioni per geo, se l'API trasmette valori compatibili di piattaforma, tipo di promozione e paese.

Se il fornitore richiede un commento, un elenco di profili o l'avvio manuale, non pubblicate il percorso nel modulo d'ordine standard. Usate una scheda separata con i campi necessari oppure lasciate il servizio nascosto fino al completamento dell'integrazione.

Il nome può essere usato solo come indicatore aggiuntivo. Il limite di questa regola è che il fornitore può cambiare la formulazione, aggiungere un'abbreviazione o usare un'altra grafia. Collegate i percorsi critici all'ID esterno e ai parametri verificabili della risposta.

Separate i dati API e le impostazioni della scheda

L'importazione non deve sovrascrivere completamente la scheda della vetrina. Prezzo di acquisto, limiti, disponibilità e parametri tecnici di solito si aggiornano dal fornitore. Nome per il cliente, descrizione, visibilità, ordine di visualizzazione e regole di ricarico restano impostazioni interne del pannello.

Per ogni campo designate la fonte di verità. Ad esempio, il volume minimo viene preso dall'API, il nome cliente dal pannello, e il prezzo della vetrina viene calcolato secondo una regola interna basata sul costo di acquisto. Senza questa separazione la sincronizzazione può cancellare una descrizione modificata manualmente o cambiare la categoria in base al nome esterno.

Verificate le modifiche di prezzo e parametri

Se il fornitore ha cambiato il prezzo, ricalcolate il prezzo della vetrina secondo la regola della scheda e verificate valuta, commissioni e margine ammesso. In caso di prezzo assente, valuta sconosciuta o variazione evidente delle condizioni, è meglio portare il percorso in stato di verifica.

In caso di modifica del minimo, del massimo o del passo della quantità, aggiornate il modulo d'ordine. Se il modulo non supporta i nuovi limiti, togliete il percorso dalla vendita. Altrimenti il cliente effettuerà un ordine che il fornitore rifiuterà dopo l'invio.

Se sono cambiati il formato del link, un campo obbligatorio, il tipo di servizio o la modalità di avvio, bloccate i nuovi ordini fino alla verifica manuale. Il limite del blocco rigoroso è che alcune schede scompariranno temporaneamente dalla vetrina, ma è più sicuro che accettare ordini incompatibili.

Gestite gli errori API e i limiti delle richieste

L'errore di una singola richiesta non deve disattivare automaticamente l'intero catalogo. Distinguete errori di autorizzazione, richiesta non valida, indisponibilità temporanea e limite di frequenza delle richieste. Per ogni gruppo serve uno scenario separato.

  • In caso di errore di autorizzazione fermate i nuovi ordini a questo fornitore e verificate l'accesso.
  • In caso di errore di formato della richiesta salvate la risposta API e correggete l'integrazione senza ripetizioni infinite.
  • In caso di errore temporaneo ripetete la richiesta con una pausa crescente.
  • In caso di limite di frequenza salvate il cursore corrente e spostate l'attività alla ripetizione.

Non contrassegnate i servizi come scomparsi finché la sincronizzazione posticipata non sarà completata con successo. Il limite delle ripetizioni aggressive è che si può esaurire più rapidamente il limite di richieste e lasciare il catalogo obsoleto per un periodo più lungo.

Conservate i percorsi per gli ordini attivi

Lo stato del servizio e lo stato dell'ordine sono entità diverse. Il servizio può scomparire dal catalogo per i nuovi clienti, ma i vecchi ordini relativi ad esso sono ancora in esecuzione. L'archiviazione della scheda o del percorso non deve interrompere il polling degli stati degli ordini già creati.

Per ogni ordine conservate l'ID esterno del servizio, l'ID esterno dell'ordine, i parametri inviati, il costo di acquisto al momento dell'avvio e la cronologia degli stati. Se il fornitore segnala un completamento parziale, un annullamento o un errore, gestite la situazione secondo le regole del pannello: rimborso, compensazione, riavvio o verifica manuale.

Il limite della memorizzazione di un'istantanea dei parametri dell'ordine è che servirà più spazio e uno schema dati accurato. Senza tale istantanea è impossibile stabilire a quali condizioni l'ordine è stato inviato, se il fornitore in seguito ha cambiato il servizio.

Testate la mappatura prima di pubblicare le schede

Dopo la configurazione verificate il percorso completo: creazione dell'ordine nel pannello, scelta del percorso, invio al fornitore, salvataggio dell'ID esterno, ricezione dello stato, annullamento e gestione del completamento parziale. Testate gruppi di servizi con limiti, link e campi obbligatori diversi.

Simulate separatamente la reimportazione, la modifica del prezzo, la scomparsa del servizio dopo un'iterazione completa riuscita, un errore a metà della paginazione e il limite di frequenza delle richieste. Questo mostrerà se il pannello archivia percorsi attivi a causa di un caricamento incompleto del catalogo.

Prestate particolare attenzione ai servizi manuali e alle posizioni con commenti. Il loro limite è che il modulo standard del pannello spesso non trasmette tutti i dati che il fornitore si aspetta. Per essi serve un modello d'ordine separato o uno stato nascosto fino al completamento dell'integrazione API.

Last Articles

Nuovo design del sito

Cosa è cambiato nel design e nelle funzionalità Abbiamo aggiornato il sito per renderlo più veloce e comodo da usare. Le modifiche principali riguard..

15/08/2026 Novità

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 Aggiornamento

Abbiamo raccolto per te tutte le promozioni e i concorsi in corso fino al 01.01.2026

1. Usa il codice promozionale "December2025" per uno sconto del 15% per tutti i nostri spettatori2. Abbiamo ridotto fino al 1° gennaio i prezzi base d..

26/12/2025 Conclusa

Collaborazione con squadre e rivenditori

I servizi Twitch sono lavorando stabile, in modo da siamo pronti a cooperare con le squadre, rivenditori, proprietari di servizi, proprietari di b..

22/10/2025 Per i partner

Gli spettatori di Twitch sono stabili, ma ci sono alcune sfumature.

Noi hanno completamente aggiornato i nostri servizi Twitch viewer, e sono ora lavoro stabile. Utilizziamo solo indirizzi IP di alta qualità per gl..

22/10/2025 Aggiornamento

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 Novità

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 Per i partner

PARTNER E REFERRAL: NUOVI TERMINI!

Grazie all'enorme popolarità dei servizi di partnership e del programma di referral, abbiamo creato un tavolo di cooperazione. L'essenza è molto sempl..

12/08/2020 Per i partner

Pannello di controllo spettatori [Twitch | Kick | YouTube | VK Video Live]

Crea il tuo piano personalizzato
Ricarica del saldo, ordine in un clic, sconti e bonus sono disponibili solo per gli utenti registrati. Registrati.
Se non hai trovato il servizio giusto o l'hai trovato a meno, scrivi al nostro supporto su Telegram o in chat e risolveremo qualsiasi problema.

 

I Nostri Servizi per gli Streamer

 

I Nostri Servizi per i Creatori di Contenuti

 

Nuovo

Bot Telegram @BOT_SP_RU_BOT

Ordina o ripeti in un minuto, saldo e stato degli ordini — direttamente su Telegram

Ripeti ordineStato degli ordiniRicarica del saldoCodici promo