Retirada de las versiones heredadas de la API de Lightning Platform

¿Qué va a cambiar?

Con el lanzamiento de la versión Summer ‘21, las siguientes versiones heredadas de la API de Lightning Platform quedarán retiradas y dejarán de admitirse en Salesforce:

• SOAP: 7.0, 8.0, 9.0, 10.0, 11.0, 12.0, 13.0, 14.0, 15.0, 16.0, 17.0, 18.0, 19.0, 20.0

• REST: v20.0

• Masiva: 16.0, 17.0, 18.0, 19.0, 20.0

Los clientes pueden seguir utilizando estas versiones heredadas de API hasta el lanzamiento de Summer ‘21, momento en el que estas versiones heredadas dejarán de estar disponibles. Cuando se retiren estas versiones heredadas, las aplicaciones que consuman las versiones afectadas de las API sufrirán una interrupción y las solicitudes fallarán y darán como resultado un error que indica que el extremo solicitado ha sido desactivado. 

¿Qué acción tengo que realizar? 

Antes del lanzamiento de la versión Summer ‘21, los clientes tendrán que modificar o actualizar sus aplicaciones para que funcionen con las versiones de las API más actuales para evitar cualquier interrupción provocada por software que haga referencia a versiones retiradas. El traslado a versiones más recientes de nuestras API ofrecerá funciones avanzadas con seguridad y rendimiento mejorados.

¿Cómo determino si se están utilizando versiones heredadas de las API afectadas en mis aplicaciones?

Para identificar aplicaciones que utilizan las API que se van a retirar, póngase en contacto con los desarrolladores de las aplicaciones que utiliza en su organización para determinar qué versiones de la API se están utilizando. 
 

Si no puede contactar con los desarrolladores de sus aplicaciones, puede revisar los registros de eventos que informan de la actividad de la API de SOAP y REST desde sus organizaciones de Salesforce siguiendo estos pasos:

1. Utilice una herramienta como Salesforce CLI para ejecutar una consulta SOQL sobre el objeto EventLogFile, que le proporcionará un registro de todas las acciones realizadas dentro de su organización en las últimas 24 horas.

   1. sfdx force:data:soql:query -q "SELECT LogFile, EventType, CreatedDate FROM EventLogFile WHERE EventType IN ('API', 'RestApi')" -u <su-nombreusuario>

2. Para cada resultado, realice una solicitud de REST empleando el extremo para obtener los datos y cópielos en un archivo .CSV.

   1. Por ejemplo /services/data/v46.0/sobjects/EventLogFile/0AT3i000005vXpWGAU/LogFile

   2. Pegue el cuerpo de la respuesta en una aplicación como Excel para ver con mayor facilidad los datos del registro de eventos como un archivo .CSV.

3. Revise cada archivo .CSV y determine si las solicitudes se están realizando a extremos con versiones de la API inferiores a la 20.

   1. SOAP / API EventType -- revise los valores de la columna API_VERSION para registros de API_TYPE de “E” o “P”

   2. REST / RestApi EventType -- revise los valores de la columna URI y observe los extremos que tengan “/v20.0” o inferior en la ruta

4. Cualquier integración que consuma las versiones 20 e inferiores se verá afectada por esta retirada de API.

Para obtener más información, consulte el módulo de Trailhead Descargar y visualizar archivos de registro de eventos. 

Para la API masiva, navegue a la página “Trabajos de carga de datos masivos” dentro de Configuración y vea los detalles de cada trabajo “Bulk V1”. Cualquier trabajo que muestre un valor de 20.0 o inferior dentro del campo “Versión de API” se verá afectado por la retirada de la API. 

¿Por qué están retirando este producto?

Estamos centrando nuestros esfuerzos de desarrollo en perfeccionar las versiones de la API más recientes para mejorar la experiencia general en Salesforce al crear funciones personalizadas a través de aplicaciones. 

¿Cómo puedo obtener más información?

Para obtener más información sobre qué funciones admite la versión de la API de SOAP más reciente, visite el sitio de desarrolladores de Salesforce y consulte la siguiente documentación:

• Presentación de la Guía del desarrollador de la API de SOAP

• Presentación de la API de REST de Lightning Platform

• Presentación de la API masiva

Para formular preguntas adicionales, puede abrir un caso con el Servicio de atención al cliente a través del portal de Ayuda y formación.