DocumentaciónExperience PlatformEtiquetas

Extremo de las configuraciones de aplicación

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Temas:

Creado para:

  • Desarrollador
WARNING
La implementación del extremo /app_configurations está en proceso de cambio a medida que se añaden, eliminan y vuelven a trabajar las funciones.

Las configuraciones de aplicación permiten almacenar y recuperar las credenciales para usarlas más adelante. El extremo /app_configurations de la API de Reactor le permite administrar mediante programación las configuraciones de aplicación dentro de la aplicación de experiencia.

Primeros pasos

El extremo utilizado en esta guía forma parte de la API de Reactor. Antes de continuar, consulte la guía de introducción para obtener información importante sobre cómo autenticarse en la API.

Recuperación de una lista de configuraciones de aplicación list

Formato de API

GET /companies/{COMPANY_ID}/app_configurations
Parámetro
Descripción
COMPANY_ID
El id de la compañía que posee las configuraciones de la aplicación.
NOTE
Mediante parámetros de consulta, las configuraciones de aplicación enumeradas se pueden filtrar según los atributos siguientes:
  • app_id
  • created_at
  • key_type
  • messaging_service
  • name
  • platform
  • updated_at
filtrado de respuestas

Solicitud

curl -X GET \
  https://reactor.adobe.io/companies/COdb0cd64ad4524440be94b8496416ec7d/app_configurations \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H "Content-Type: application/vnd.api+json" \
  -H 'Accept: application/vnd.api+json;revision=1'

Respuesta

Una respuesta correcta devuelve una lista de configuraciones de aplicación.

{
  "data": [
    {
      "id": "AC40c339ab80d24c958b90d67b698602eb",
      "type": "app_configurations",
      "attributes": {
        "created_at": "2020-12-14T17:31:10.626Z",
        "updated_at": "2020-12-14T17:31:10.626Z",
        "app_id": "com.adobe.test_app",
        "name": "Kessel Apns App",
        "platform": "mobile",
        "messaging_service": "apns",
        "key_type": "p8_file"
      },
      "relationships": {
        "company": {
          "links": {
            "related": "https://reactor.adobe.io/app_configurations/AC40c339ab80d24c958b90d67b698602eb/company"
          },
          "data": {
            "id": "CO2bf094214ffd4785bb4bcf88c952a7c1",
            "type": "companies"
          }
        }
      },
      "links": {
        "company": "https://reactor.adobe.io/companies/CO2bf094214ffd4785bb4bcf88c952a7c1",
        "self": "https://reactor.adobe.io/app_configurations/AC40c339ab80d24c958b90d67b698602eb"
      }
    }
  ],
  "meta": {
    "pagination": {
      "current_page": 1,
      "next_page": null,
      "prev_page": null,
      "total_pages": 1,
      "total_count": 1
    }
  }
}

Búsqueda de una configuración de aplicación lookup

Puede buscar una configuración de aplicación proporcionando su ID en la ruta de una petición GET.

Formato de API

GET /app_configurations/{APP_CONFIGURATION_ID}
Parámetro
Descripción
APP_CONFIGURATION_ID
El id de la configuración de la aplicación que desea buscar.

Solicitud

curl -X GET \
  https://reactor.adobe.io/app_configurations/AC40c339ab80d24c958b90d67b698602eb \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H "Content-Type: application/vnd.api+json" \
  -H 'Accept: application/vnd.api+json;revision=1'

Respuesta

Una respuesta correcta devuelve los detalles de la configuración de la aplicación.

{
  "data": {
    "id": "AC40c339ab80d24c958b90d67b698602eb",
    "type": "app_configurations",
    "attributes": {
      "created_at": "2020-12-14T17:31:10.626Z",
      "updated_at": "2020-12-14T17:31:10.626Z",
      "app_id": "com.adobe.test_app",
      "name": "Kessel Apns App",
      "platform": "mobile",
      "messaging_service": "apns",
      "key_type": "p8_file"
    },
    "relationships": {
      "company": {
        "links": {
          "related": "https://reactor.adobe.io/app_configurations/AC40c339ab80d24c958b90d67b698602eb/company"
        },
        "data": {
          "id": "CO2bf094214ffd4785bb4bcf88c952a7c1",
          "type": "companies"
        }
      }
    },
    "links": {
      "company": "https://reactor.adobe.io/companies/CO2bf094214ffd4785bb4bcf88c952a7c1",
      "self": "https://reactor.adobe.io/app_configurations/AC40c339ab80d24c958b90d67b698602eb"
    }
  }
}

Creación de una configuración de aplicación create

Puede crear una nueva configuración de aplicación realizando una petición POST.

Formato de API

POST /companies/{COMPANY_ID}/app_configurations
Parámetro
Descripción
COMPANY_ID
El id de la compañía en la que define la configuración de la aplicación.

Solicitud

curl -X POST \
  https://reactor.adobe.io/companies \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/vnd.api+json;revision=1' \
  -d '{
        "data": {
          "attributes": {
            "name": "Kessel Apns App",
            "app_id": "com.adobe.test_app",
            "platform": "mobile",
            "messaging_service": "apns",
            "key_type": "p8_file",
            "push_credential": {
              "bundleId": "com.adobe.test_app",
              "keyId": "{KEY_ID}",
              "p8": "{SECRET}",
              "teamId": "{TEAM_ID}"
            }
          },
          "type": "app_configurations"
        }
      }'
Propiedad
Descripción
platform
La plataforma en la que se ejecuta la aplicación (web o móvil). Esto determina qué servicios de mensajería están disponibles.
messaging_service
El servicio de mensajería asociado a la aplicación, como Apple Push Notification service (APNs) y Firebase Cloud Messaging (FCM). Esto determina qué tipos de claves se pueden utilizar.
key_type
Representa el protocolo que admite un proveedor de servicios push y determina el formato del objeto push_credential. A medida que evolucionan los protocolos para los servicios de mensajería, se crean nuevos valores key_type para admitir los protocolos actualizados.
push_credential
El valor de credencial real, que se cifra en reposo. Normalmente, este campo no se descifra ni se incluye en las respuestas de API. Solo ciertos servicios de Adobe pueden obtener una respuesta que contenga una credencial push descifrada.

Respuesta

Una respuesta correcta devuelve los detalles de la configuración de la aplicación recién creada.

{
  "data": {
    "id": "AC40c339ab80d24c958b90d67b698602eb",
    "type": "app_configurations",
    "attributes": {
      "created_at": "2020-12-14T17:31:10.626Z",
      "updated_at": "2020-12-14T17:31:10.626Z",
      "app_id": "com.adobe.test_app",
      "name": "Kessel Apns App",
      "platform": "mobile",
      "messaging_service": "apns",
      "key_type": "p8_file"
    },
    "relationships": {
      "company": {
        "links": {
          "related": "https://reactor.adobe.io/app_configurations/AC40c339ab80d24c958b90d67b698602eb/company"
        },
        "data": {
          "id": "CO2bf094214ffd4785bb4bcf88c952a7c1",
          "type": "companies"
        }
      }
    },
    "links": {
      "company": "https://reactor.adobe.io/companies/CO2bf094214ffd4785bb4bcf88c952a7c1",
      "self": "https://reactor.adobe.io/app_configurations/AC40c339ab80d24c958b90d67b698602eb"
    }
  }
}

Actualización de la configuración de una aplicación

Puede actualizar una configuración de aplicación incluyendo su ID en la ruta de una petición del PATCH.

Formato de API

PATCH /app_configurations/{APP_CONFIGURATION_ID}
Parámetro
Descripción
APP_CONFIGURATION_ID
El id de la configuración de la aplicación que desea actualizar.

Solicitud

La siguiente solicitud actualiza el app_id para una configuración de aplicación existente.

curl -X PATCH \
  https://reactor.adobe.io/app_configurations/AC40c339ab80d24c958b90d67b698602eb \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/vnd.api+json;revision=1' \
  -d '{
        "data": {
          "attributes": {
            "app_id": "com.adobe.test_app_2"
          },
          "id": "AC40c339ab80d24c958b90d67b698602eb",
          "type": "app_configurations"
        }
      }'
Propiedad
Descripción
attributes

Un objeto cuyas propiedades representan los atributos que se van a actualizar para la configuración de la aplicación. Cada clave representa el atributo de configuración de la aplicación que se va a actualizar, junto con el valor correspondiente al que se debe actualizar.

Se pueden actualizar los siguientes atributos para las configuraciones de la aplicación:

  • app_id
  • key_type
  • messaging_service
  • name
  • platform
  • push_credential
id
El id de la configuración de la aplicación que desea actualizar. Debe coincidir con el valor {APP_CONFIGURATION_ID} proporcionado en la ruta de solicitud.
type
Tipo de recurso que se actualiza. Para este extremo, el valor debe ser app_configurations.

Respuesta

Una respuesta correcta devuelve los detalles de la configuración actualizada de la aplicación.

{
  "data": {
    "id": "AC40c339ab80d24c958b90d67b698602eb",
    "type": "app_configurations",
    "attributes": {
      "created_at": "2020-12-14T17:31:10.626Z",
      "updated_at": "2020-12-14T17:31:21.787Z",
      "app_id": "com.adobe.test_app_2",
      "name": "Kessel Apns App",
      "platform": "mobile",
      "messaging_service": "apns",
      "key_type": "p8_file"
    },
    "relationships": {
      "company": {
        "links": {
          "related": "https://reactor.adobe.io/app_configurations/AC40c339ab80d24c958b90d67b698602eb/company"
        },
        "data": {
          "id": "CO2bf094214ffd4785bb4bcf88c952a7c1",
          "type": "companies"
        }
      }
    },
    "links": {
      "company": "https://reactor.adobe.io/companies/CO2bf094214ffd4785bb4bcf88c952a7c1",
      "self": "https://reactor.adobe.io/app_configurations/AC40c339ab80d24c958b90d67b698602eb"
    }
  }
}

Eliminación de una configuración de aplicación

Puede eliminar una configuración de aplicación incluyendo su ID en la ruta de una petición DELETE.

Formato de API

DELETE /app_configurations/{APP_CONFIGURATION_ID}
Parámetro
Descripción
APP_CONFIGURATION_ID
El id de la configuración de la aplicación que desea eliminar.

Solicitud

curl -X DELETE \
  https://reactor.adobe.io/app_configurations/AC40c339ab80d24c958b90d67b698602eb \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H "Content-Type: application/vnd.api+json" \
  -H 'Accept: application/vnd.api+json;revision=1'

Respuesta

Una respuesta correcta devuelve el estado HTTP 204 (sin contenido) sin cuerpo de respuesta, lo que indica que se ha eliminado la configuración de la aplicación.

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743