Segmentation

Ids de los fans de una ejecución, por páginas de hasta 25000

Devuelve solo los fan_id que devolvería /segments/execute para la misma petición: misma definition, mismos tenants (los del JWT, nunca del cuerpo), mismos groups y mismo definition.limit/offset. Sin datos de contacto ni enriquecimiento de consentimiento.

Paginación por clave (after_user_id): ids distintos y no vacíos en orden ascendente; la siguiente página se pide con after_user_id = next_after_user_id de la anterior. Cada página es una consulta nueva sobre datos vivos, no una instantánea: un fan que entra o sale entre dos páginas no desplaza a los demás, pero puede aparecer o no según el momento. page no se admite (400 INVALID_PAGINATION).

  • page_size: 1–25000 (default 100).
  • has_more: hay otra página; next_after_user_id es null cuando no la hay.

Rate limit: comparte el límite de /segments/execute (30 req/min por tenant): las páginas de ambos endpoints gastan el mismo presupuesto.

post/segments/execute-ids

Request

  • Base URL: http://localhost:8081
  • URL: http://localhost:8081/segments/execute-ids
  • Auth: HTTP bearer

Request body

page_sizeinteger
after_user_idstring nullable

Último id de la página anterior; ausente o null para la primera.

Example request

{
  "definition": {
    "stanzas": [
      {
        "id": "stanza_001",
        "criteria": [
          {
            "id": "crit_001",
            "criterion_id": "user_age",
            "modifiers": {
              "distance": {
                "radius": 50
              },
              "frequency": {
                "count": 3
              },
              "time_range": {
                "value": 30
              }
            },
            "metadata": {
              "criteriaName": "Campañas abiertas",
              "dataType": "ENTITY",
              "category": "Interacción"
            }
          }
        ]
      }
    ],
    "limit": 50
  },
  "groups": {
    "total_groups": 10,
    "group_number": 1
  }
}

Response

Página de ids

successboolean
fan_idsstring[]
page_sizeinteger
has_moreboolean
next_after_user_idstring nullable

Changes

No recorded changes to this operation across all 1 revision of this API.