Puntos finales de API y SDK

Busca la URL correcta del panel, el endpoint de REST API y el punto final de SDK para tu instancia de Braze. Necesitas estas URL para iniciar sesión, realizar llamadas a la API e integrar el SDK.

Braze administra varias instancias diferentes para nuestro panel, SDK y endpoints REST, que llamamos “clústeres”. Tu administrador de incorporación de Braze te indicará en qué clúster te encuentras. Para obtener más información sobre el SDK de Braze, consulta el Braze 101, un curso de Braze Learning.

Iniciar sesión en dashboard.braze.com te enviará automáticamente a la dirección de clúster correcta.

Importante

Al integrar tu SDK, usa el punto final de SDK. Al realizar llamadas a nuestra REST API, usa el endpoint REST.

Para obtener más detalles sobre el acceso a la API, consulta nuestro artículo de resumen de la API.

URL personalizadas

En lugar del punto final de SDK estándar para tu clúster, puedes configurar el SDK de Braze para que envíe sus solicitudes de red a una URL personalizada, como un proxy o un dominio personalizado. Los siguientes SDK admiten URL personalizadas:

• SDK de Braze para Swift: versión 11.8.0 y posteriores
• SDK de Braze para Android: versión 2.11 y posteriores

Configurar una URL personalizada

Establece tu URL personalizada en el mismo lugar donde configuras el punto final de SDK al inicializar el SDK. Para conocer todos los pasos de integración, consulta Integrar el SDK de Braze.

• swift
• android

1
2
3
4
5
6

let configuration = Braze.Configuration(
  apiKey: "YOUR_APP_IDENTIFIER_API_KEY",
  endpoint: "YOUR_CUSTOM_URL"
)
let braze = Braze(configuration: configuration)
AppDelegate.braze = braze

1
2
3
4

BRZConfiguration *configuration = [[BRZConfiguration alloc] initWithApiKey:@"YOUR_APP_IDENTIFIER_API_KEY"
                                                                  endpoint:@"YOUR_CUSTOM_URL"];
Braze *braze = [[Braze alloc] initWithConfiguration:configuration];
AppDelegate.braze = braze;

1
2
3
4
5

<?xml version="1.0" encoding="utf-8"?>
<resources>
  <string translatable="false" name="com_braze_api_key">YOUR_APP_IDENTIFIER_API_KEY</string>
  <string translatable="false" name="com_braze_custom_endpoint">YOUR_CUSTOM_URL</string>
</resources>

1
2
3
4
5

BrazeConfig brazeConfig = new BrazeConfig.Builder()
  .setApiKey("YOUR_APP_IDENTIFIER_API_KEY")
  .setCustomEndpoint("YOUR_CUSTOM_URL")
  .build();
Braze.configure(this, brazeConfig);

1
2
3
4
5

val brazeConfig = BrazeConfig.Builder()
  .setApiKey("YOUR_APP_IDENTIFIER_API_KEY")
  .setCustomEndpoint("YOUR_CUSTOM_URL")
  .build()
Braze.configure(this, brazeConfig)

Probar la configuración de tu proxy

Comprueba que tu proxy funciona como esperas antes de publicar tu aplicación en producción. Para confirmar que el SDK envía las solicitudes a tu URL personalizada, usa el registro detallado:

1. Habilita el registro detallado en tu compilación de desarrollo antes de inicializar el SDK. Para ver el código de cada SDK, consulta Registro detallado.
2. Ejecuta tu aplicación en un dispositivo de prueba o en un simulador. El SDK envía una solicitud cuando se inicia una sesión.
3. En tus registros, busca las entradas de las solicitudes y confirma que la URL de la solicitud coincide con tu URL personalizada.
4. Confirma que tu proxy recibe las solicitudes del SDK.

Si no ves ninguna solicitud a tu URL personalizada en Android, verifica tu clave de API y la configuración del endpoint. Para ver ejemplos de cómo aparecen las entradas de solicitudes en los registros, consulta Leer los registros detallados.

Importante

Desactiva el registro detallado antes de publicar tu aplicación en producción.