Lista los grupos de suscripción del usuario
/subscription/user/status
Utiliza este punto final para listar y obtener los grupos de suscripción de un determinado usuario.
Si quieres ver ejemplos o probar este punto final para Grupos de suscripción por correo electrónico:
Si quieres ver ejemplos o probar este punto final para Grupos de Suscripción SMS:
Si quieres ver ejemplos o probar este punto final para Grupos de WhatsApp:
Requisitos previos
Para utilizar este punto final, necesitarás una clave de API con el permiso subscription.groups.get
.
Límite de velocidad
Aplicamos el límite de velocidad predeterminado de Braze de 250 000 solicitudes por hora a este punto final, como se documenta en Límites de velocidad de la API.
Parámetros de la solicitud
Parámetro | Obligatoria | Tipo de datos | Descripción |
---|---|---|---|
external_id |
Obligatoria | Cadena | La dirección external_id del usuario (debe incluir al menos uno y como máximo 50 external_ids ). |
email |
Requerido* | Cadena | La dirección de correo electrónico del usuario, puede pasarse como una matriz de cadenas. Debes incluir al menos una dirección de correo electrónico (con un máximo de 50). |
phone |
Requerido* | Cadena en E.164 formato | El número de teléfono del usuario. Debe incluir al menos un número de teléfono (con un máximo de 50). |
limit |
Opcional | Entero | El límite del número máximo de resultados devueltos. limit predeterminado (y como máximo) es 100. |
offset |
Opcional | Entero | Número de plantillas que saltar antes de devolver el resto de plantillas que se ajustan a los criterios de búsqueda. |
Si hay varios usuarios (varios external_ids
) que comparten la misma dirección de correo electrónico, todos los usuarios serán devueltos como usuarios separados (aunque tengan la misma dirección de correo electrónico o grupo de suscripción).
Ejemplo de solicitud
https://rest.iad-03.braze.com/subscription/user/status?external_id[]=1&external_id[]=2
1
2
curl --location -g --request GET 'https://rest.iad-01.braze.com/subscription/user/status?external_id={{external_id}}&limit=100&offset=1&phone=+11112223333' \
--header 'Authorization: Bearer YOUR-REST-API-KEY'
1
2
curl --location -g --request GET 'https://rest.iad-01.braze.com/subscription/user/status?external_id={{external_id}}&[email protected]&limit=100&offset=0' \
--header 'Authorization: Bearer YOUR-REST-API-KEY'
Ejemplo de respuesta
1
2
3
4
5
6
7
8
9
10
11
12
13
{
"success": true,
"subscription_groups": [
{
"subscription_group_id": "group_id_1",
"subscription_status": "subscribed"
},
{
"subscription_group_id": "group_id_2",
"subscription_status": "unsubscribed"
}
]
}