Cómo vincular los servicios del proveedor con las tarjetas del panel SMM mediante API
Por qué separar el catálogo del proveedor del escaparate del panel
La API del proveedor suele devolver un catálogo técnico: ID externo, nombre, precio, límites, estado y parámetros del pedido. En el panel SMM, esa misma posición debe encajar en una estructura comprensible para el cliente: plataforma, tipo de promoción, geografía, formato del enlace, calidad de la audiencia o velocidad de inicio.
Si se muestra el catálogo externo sin procesar, en el escaparate aparecerán nombres técnicos, duplicados y posiciones no disponibles. El mapeo separa la lógica de compra de la tarjeta del cliente. Un servicio del proveedor no tiene por qué ser un servicio independiente en el panel.
Qué datos hay que obtener mediante la API
Guarde los datos originales del proveedor por separado de la configuración del escaparate. El ID externo no se puede sustituir por el identificador interno del panel: se necesita para crear el pedido, obtener el estado, cancelar y analizar errores. También es útil almacenar la hora de la última sincronización y la respuesta completa de la API o una instantánea de ella.
- Identificador del proveedor e ID externo del servicio.
- Nombre, descripción y categoría externa.
- Precio de compra, moneda y unidad de cálculo.
- Volumen mínimo, máximo y paso de cantidad.
- Estado de disponibilidad, existencias e indicador de pausa temporal.
- Requisitos de enlace, inicio de sesión, publicación, comentario y geografía.
- Indicadores de inicio manual, cancelación, reinicio y ejecución parcial.
La desventaja de la importación automática es que los proveedores nombran los mismos campos de forma distinta y a veces envían datos incompletos. El nombre del servicio no sirve para una vinculación estable: pueden cambiarlo sin modificar el ID externo.
Ejemplo de solicitud y respuesta del catálogo de servicios
El formato de la API depende del proveedor, pero la lógica suele ser la misma: el panel envía la clave de acceso y los parámetros de la página, y en respuesta recibe un array de servicios. Por ejemplo, una solicitud del catálogo con cursor puede verse así:
GET /api/services?cursor=eyJwYWdlIjoyfQ
Respuesta condicional de la API:
{ "services": [ { "id": "SP-1042", "name": "Global Followers", "platform": "twitch", "type": "followers", "price": "12.50", "min": 100, "max": 10000, "status": "active" } ], "next_cursor": "eyJwYWdlIjozfQ" }
Los campos de la respuesta no conviene escribirlos directamente en la tarjeta del escaparate. Primero hay que validarlos, guardarlos en el catálogo del proveedor y vincularlos con las reglas internas. La desventaja de trabajar solo con la tarjeta final es que la importación puede sobrescribir el nombre del cliente, la descripción o la categoría seleccionada manualmente.
Primero defina la estructura de categorías en el panel
Antes de la importación, defina la taxonomía del panel. El nivel superior suele describir la plataforma, el siguiente, la acción: seguidores, visualizaciones, reacciones, comentarios, espectadores de la transmisión u otro formato. Dentro se pueden dividir los servicios por geografía, tipo de audiencia, velocidad y condiciones de compensación.
Para cada categoría, defina los atributos obligatorios. En las visualizaciones puede ser el tipo de enlace y el formato del contenido; en los seguidores, la plataforma, la geografía y el tipo de perfil permitido. La desventaja de una estructura demasiado detallada es que el catálogo se vuelve más difícil de mantener y servicios similares empiezan a diferenciarse solo por matices internos.
Guarde las vinculaciones del proveedor y del escaparate por separado
La vinculación entre el servicio del proveedor y la tarjeta del panel debe almacenarse en una tabla o entidad separada. En ella se necesitan el proveedor, el ID externo, la tarjeta interna, la categoría, la regla de precio, la prioridad de la ruta, el estado de publicación y la fecha de la última verificación exitosa.
Este esquema permite sustituir al proveedor sin cambiar la URL de la tarjeta y sin perder el historial de pedidos. Ejemplo de fila de mapeo en JSON:
{ "supplier_id": "supplier_a", "external_service_id": "SP-1042", "panel_category": "twitch_followers", "showcase_card_id": "followers_global", "route_priority": 1, "status": "active" }

Las vinculaciones pueden ser distintas, pero para cada una defina de antemano la regla de actualización.
- Un servicio del proveedor — una tarjeta, si tiene parámetros únicos y una forma de pedido propia.
- Varios servicios de distintos proveedores — una tarjeta, si son compatibles en requisitos y condiciones.
- Un servicio del proveedor — varias tarjetas, si el escaparate lo divide por idioma, segmento o forma de venta.
La combinación de varios proveedores en una sola tarjeta tiene una desventaja: la velocidad, la disponibilidad y las condiciones reales de ejecución pueden variar. No combine rutas con distintos formatos de enlace, límites o campos obligatorios.
Importe el catálogo página por página
El proveedor puede entregar el catálogo por páginas mediante número, desplazamiento o cursor. La primera respuesta no necesariamente contiene todos los servicios. Solicite la siguiente página mientras la API entregue un cursor, un enlace de continuación u otra señal explícita de que hay datos.
Con la paginación por cursor, el procesamiento es así: el panel recibe la página, guarda todos los servicios, los registra como encontrados en el ciclo actual y solo después pasa al siguiente cursor. Si el campo next_cursor no está presente, se considera que el recorrido ha terminado.
- Cree un identificador del ciclo de sincronización actual.
- Solicite la primera página y guarde los servicios recibidos.
- Para cada servicio, actualice el campo last_seen_sync con el identificador del ciclo.
- Guarde el cursor de la siguiente página antes de ejecutar la siguiente solicitud.
- Tras recorrer correctamente todas las páginas, compare el catálogo con el ciclo actual.
La desventaja de la carga secuencial de páginas es que la importación completa puede tardar más. Las solicitudes paralelas aceleran el proceso, pero aumentan el riesgo de chocar con el límite de la API u obtener páginas en estados distintos del catálogo.
No cree duplicados en la resincronización
Para buscar un servicio existente, use una clave compuesta: identificador del proveedor e ID externo del servicio. En cada reimportación, busque primero el registro por ese par y luego actualice los campos técnicos. Cree un registro nuevo solo si esa clave no existe.
No use el nombre, el precio ni la categoría para la deduplicación. Dos servicios distintos pueden coincidir en esos valores, y el proveedor puede renombrar la posición sin cambiar el ID externo. Para las vinculaciones con el escaparate también se necesita un control único: la misma ruta no debe aparecer dos veces tras relanzar la tarea.
Es útil limitar la unicidad a nivel de base de datos: supplier_id + external_service_id para el catálogo del proveedor y supplier_id + external_service_id + showcase_card_id para el mapeo. La desventaja de una restricción estricta es que, si hay un error en una vinculación antigua, habrá que corregirla explícitamente en lugar de crear un registro nuevo encima.
Cómo detectar servicios eliminados y desaparecidos
Un servicio solo se puede considerar desaparecido tras recorrer correctamente todas las páginas. Si la sincronización se detuvo por un error, un límite de solicitudes o la indisponibilidad de la API, las posiciones ausentes en la parte ya cargada del catálogo no se pueden marcar como eliminadas.
Tras completar la importación, busque los servicios de ese proveedor cuyo last_seen_sync no sea igual al identificador del ciclo actual. Se les asigna el estado «no encontrado» o «archivado», se desactivan para nuevos pedidos y se envían a revisión. El ID externo, el historial de cambios y las vinculaciones con pedidos se conservan.
Un servicio desaparecido debe archivarse, no eliminarse. El proveedor puede devolverlo al catálogo más tarde, cambiar el filtro de la respuesta u ocultar temporalmente la posición. La vinculación archivada se puede restaurar en la siguiente importación si el mismo ID externo vuelve a aparecer.
Qué hacer cuando cambia el ID externo del servicio
Si el proveedor creó un servicio nuevo en lugar del antiguo, el nuevo ID externo no se puede considerar automáticamente una continuación del anterior. Incluso con el mismo nombre y precio, los requisitos del pedido, la geografía, el tipo de audiencia o las condiciones de compensación de la posición pueden haber cambiado.
Pase la vinculación antigua al archivo, retire la ruta de la venta y consérvela para los pedidos antiguos. Importe el nuevo servicio como un registro separado. Después, cree un nuevo mapeo manualmente o según una regla segura, si los parámetros técnicos son totalmente compatibles.
La vinculación automática por nombre puede acelerar el trabajo, pero su desventaja es el riesgo de enviar el pedido a otro servicio con condiciones inadecuadas. Para el cambio de ID es mejor usar el estado «requiere revisión» que una sustitución silenciosa de la ruta.
Configure el mapeo por campos técnicos estables
La distribución automática de servicios es mejor construirla a partir de un conjunto de campos: plataforma, tipo de servicio, geografía, formato del enlace, volumen mínimo, parámetros adicionales y estado. Por ejemplo, un servicio puede entrar en la categoría de visualizaciones por geografía si la API entrega valores compatibles de plataforma, tipo de promoción y país.
Si el proveedor requiere un comentario, una lista de perfiles o un inicio manual, no publique la ruta en el formulario de pedido estándar. Use una tarjeta separada con los campos necesarios o deje el servicio oculto hasta completar la integración.
El nombre solo se puede usar como atributo adicional. La desventaja de esa regla es que el proveedor puede cambiar la formulación, añadir una abreviatura o usar otra grafía. Vincule las rutas críticas al ID externo y a parámetros verificables de la respuesta.
Separe los datos de la API y la configuración de la tarjeta
La importación no debe sobrescribir por completo la tarjeta del escaparate. El precio de compra, los límites, la disponibilidad y los parámetros técnicos suelen actualizarse desde el proveedor. El nombre para el cliente, la descripción, la visibilidad, el orden de visualización y las reglas de margen siguen siendo configuración interna del panel.
Para cada campo, asigne una fuente de verdad. Por ejemplo, el volumen mínimo se toma de la API, el nombre del cliente, del panel, y el precio del escaparate se calcula según una regla interna a partir del coste de compra. Sin esa separación, la sincronización puede borrar una descripción editada manualmente o cambiar la categoría según el nombre externo.
Verifique los cambios de precio y parámetros
Si el proveedor cambió el precio, recalcule el precio del escaparate según la regla de la tarjeta y compruebe la moneda, las comisiones y el margen admisible. Si falta el precio, la moneda es desconocida o las condiciones cambian de forma notable, es mejor pasar la ruta a estado de revisión.
Si cambia el mínimo, el máximo o el paso de cantidad, actualice el formulario de pedido. Si el formulario no admite las nuevas restricciones, retire la ruta de la venta. De lo contrario, el cliente realizará un pedido que el proveedor rechazará después del envío.
Si cambian el formato del enlace, el campo obligatorio, el tipo de servicio o el modo de inicio, bloquee los nuevos pedidos hasta la revisión manual. La desventaja del bloqueo estricto es que parte de las tarjetas desaparecerá temporalmente del escaparate, pero es más seguro que aceptar pedidos incompatibles.
Gestione los errores de la API y los límites de solicitudes
Un error en una sola solicitud no debe desactivar automáticamente todo el catálogo. Diferencie los errores de autorización, de solicitud incorrecta, de indisponibilidad temporal y de límite de frecuencia de solicitudes. Cada grupo necesita su propio escenario.
- Ante un error de autorización, detenga los nuevos pedidos a ese proveedor y compruebe el acceso.
- Ante un error de formato de solicitud, guarde la respuesta de la API y corrija la integración sin reintentos infinitos.
- Ante un error temporal, repita la solicitud con una pausa creciente.
- Ante un límite de frecuencia, guarde el cursor actual y reprograme la tarea.
No marque servicios como desaparecidos hasta que la sincronización aplazada finalice correctamente. La desventaja de los reintentos agresivos es que se puede agotar antes el límite de solicitudes y dejar el catálogo desactualizado durante más tiempo.
Conserve las rutas para los pedidos activos
El estado del servicio y el estado del pedido son entidades distintas. El servicio puede desaparecer del catálogo para nuevos clientes, pero los pedidos antiguos con él todavía se están ejecutando. El archivado de la tarjeta o de la ruta no debe detener la consulta de estados de los pedidos ya creados.
Para cada pedido, guarde el ID externo del servicio, el ID externo del pedido, los parámetros enviados, el coste de compra en el momento del inicio y el historial de estados. Si el proveedor informa de una ejecución parcial, una cancelación o un error, gestione la situación según las reglas del panel: reembolso, compensación, reinicio o revisión manual.
La desventaja de almacenar una instantánea de los parámetros del pedido es que requerirá más espacio y un esquema de datos cuidadoso. Sin esa instantánea, es imposible determinar en qué condiciones se envió el pedido si el proveedor cambió el servicio después.
Pruebe el mapeo antes de publicar las tarjetas
Tras la configuración, compruebe el recorrido completo: creación del pedido en el panel, selección de la ruta, envío al proveedor, guardado del ID externo, obtención del estado, cancelación y gestión de la ejecución parcial. Pruebe grupos de servicios con distintos límites, enlaces y campos obligatorios.
Simule por separado la reimportación, el cambio de precio, la desaparición de un servicio tras un recorrido completo exitoso, un error en medio de la paginación y el límite de frecuencia de solicitudes. Esto mostrará si el panel archiva rutas activas debido a una carga incompleta del catálogo.
Preste especial atención a los servicios manuales y a las posiciones con comentarios. Su desventaja es que el formulario estándar del panel a menudo no transmite todos los datos que espera el proveedor. Para ellos se necesita una plantilla de pedido separada o un estado oculto hasta completar la integración de la API.
Last Articles
Qué cambió en el diseño y la funcionalidad Actualizamos el sitio para que trabajar con él sea más rápido y cómodo. Los cambios principales afectan a ..
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. Utilice el código promocional "December2025" para un 15% de descuento para todos nuestros espectadores2. Hemos reducido hasta el 1 de enero los pre..
Los servicios de Twitch son trabajando de manera estable, por lo que estamos listos para cooperar con escuadrones, revendedores, propietarios de s..
Nosotros hemos actualizado completamente nuestros servicios de visualización de Twitch, y ahora están trabajando estable. Solo usamos direcciones ..
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..
Debido a la enorme popularidad de los servicios de asociación y del programa de referencia, hemos creado una tabla de cooperación. La esencia es muy s..
Nuestros Servicios para Streamers
Nuestros Servicios para Creadores de Contenido










