¿Necesitas ayuda con tu integración de Topsort?
Habla con nosotros, el equipo de ingeniería de integraciones.
Contáctanos a través de tu canal de mensajería dedicado o en{" "}
support@topsort.com.
Si aún no eres cliente,{" "}
agenda una demo con nuestro
equipo de ventas.
;
};
La [Segments API](/en/api-reference/segments-service) de Topsort permite a nuestros clientes crear y gestionar grupos de usuarios para propósitos de segmentación. Después de crear segmentos en nuestra plataforma, pueden usarse como segmentación en la creación de campañas.
## Cargar Usuarios a un Segmento
Una vez que se crea un segmento, los usuarios pueden cargarse usando nuestras APIs. Topsort soporta tres acciones:
* **Add**: Agregar nuevos usuarios al segmento existente, sin realizar cambios a los existentes.
* **Remove**: Eliminar usuarios específicos del segmento.
* **Replace**: Sobrescribir el segmento completo con una nueva lista de usuarios
Las listas de usuarios deben seguir esta especificación:
* El formato del archivo es .txt
* Sin encabezados
* Un Opaque User ID por fila, sin correos electrónicos ni información personal.
## Restringir un Segmento a Vendors Específicos
Por defecto, un segmento nuevo es **global**: cualquier vendor de tu marketplace puede seleccionarlo como segmentación. Para limitar un segmento a vendors específicos, gestiona su lista de vendors con tu Advanced API Key:
* **[Listar vendors](/es/api-reference/segments-service/list-vendors-assigned-to-a-segment)**: `GET /public/v1/segment-service/segments/{segment_id}/vendors` devuelve los vendors asignados al segmento. Una lista `vendorIds` vacía significa que el segmento es global.
* **[Agregar vendors](/es/api-reference/segments-service/add-vendors-to-a-segment)**: `PUT /public/v1/segment-service/segments/{segment_id}/vendors` agrega los vendors indicados. Los vendors ya asignados se mantienen. Agregar el primer vendor convierte un segmento global en uno restringido.
* **[Eliminar vendors](/es/api-reference/segments-service/remove-vendors-from-a-segment)**: `DELETE /public/v1/segment-service/segments/{segment_id}/vendors` elimina los vendors indicados. Eliminar el último vendor vuelve a hacer global el segmento.
Los IDs de segmento y de vendor son tus IDs externos. Cada solicitud acepta hasta 100 IDs de vendor, y todos los endpoints devuelven la lista de vendors resultante del segmento:
```bash theme={null}
curl -X PUT https://api.topsort.com/public/v1/segment-service/segments/{segment_id}/vendors \
-H "Authorization: Bearer YOUR_ADVANCED_API_KEY" \
-H "Content-Type: application/json" \
-d '{"vendorIds": ["vendor-a", "vendor-b"]}'
```
```json theme={null}
{
"id": "{segment_id}",
"vendorIds": ["vendor-a", "vendor-b"]
}
```
Para saber qué segmentos puede usar un vendor, llama a [Retrieve a list of segments](/es/api-reference/segments-service/retrieve-a-list-of-segments) con el parámetro de consulta `vendor_id`. La respuesta contiene los segmentos globales más los segmentos asignados a ese vendor.
