Establecer la clave de autenticación del SDK principal

Utiliza este punto final SDK para establecer una clave de autenticación SDK como clave principal para tu aplicación.

Requisitos previos

Para utilizar este punto final, necesitarás una clave de API con el permiso sdk_authentication.primary.

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.

Cuerpo de la solicitud

1
2
Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY

1
2
3
4
{
  "app_id": "App API identifier",
  "key_id": "key id"
}

Parámetros de la solicitud

Ejemplo de solicitud

1
2
3
4
5
6
7
curl --location --request PUT 'https://rest.iad-01.braze.com/app_group/sdk_authentication/primary' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY' \
--data-raw '{
  "app_id": "01234567-89ab-cdef-0123-456789abcdef",
  "key_id": "abcdef12-3456-7890-abcd-ef1234567890"
}'

Respuesta

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
{
  "keys": [
    {
      "id": "abcdef12-3456-7890-abcd-ef1234567890",
      "rsa_public_key": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAvvD+fgA0YuCUd/v35htn...\n-----END PUBLIC KEY-----",
      "description": "SDK Authentication Key for iOS App",
      "is_primary": true
    },
    {
      "id": "fedcba98-7654-3210-fedc-ba9876543210",
      "rsa_public_key": "-----BEGIN PUBLIC KEY-----\nqWGfHOAiIwVzC/bTxwQZQQVzm/3ktgdNXRUDm5aIwVzCtxbNm5aIxOAiIwVzVHOA...\n-----END PUBLIC KEY-----",
      "description": "SDK Authentication Key for Android App",
      "is_primary": false
    }
  ]
}

Parámetros de respuesta

Reglas de validación

Este punto final tiene las siguientes reglas de validación:

• Debekey_id ser un ID de clave de autenticación SDK válido.
• Debe ser un identificadorapp_id API válido de la aplicación.
• La clave de autenticación SDK debe existir para la aplicación especificada.