Retirada de las versiones 21.0 a la 30.0 de la API de Salesforce Platform

Fecha de publicación original - 20 de octubre de 2020

Actualizado - 4 de mayo de 2024
 

¿Cuál es el estado de las versiones 21 a la 30 de las API de SOAP, REST y masiva?

• Actual: Estas versiones de la API están desusadas (desde la versión Summer ‘22) y ya no se tienen cobertura. Puede utilizarlas, pero si encuentra problemas y registra un caso con el Servicio de asistencia de Salesforce, deberá primero actualizar la versión de la API. No hay solución de problemas ni de fallos para estas versiones de API heredadas.

• Futuro: Versión Summer ‘25: Estas versiones de la API quedarán retiradas Las aplicaciones que consumen las versiones quedarán interrumpidas porque las llamadas fallarán y la respuesta será un error que indica que el extremo solicitado no se encuentra y la plataforma no puede procesarlas. A continuación están los errores:

  • La API de REST devuelve 410: GONE.

  • La API de SOAP devuelve 500: UNSUPPORTED_API_VERSION.

  • La API masiva devuelve 400: InvalidVersion.

Nota: Las versiones 7.0 a la 20.0 de la API se retiraron y no están disponibles desde el lanzamiento de la versión Summer ’22.

¿Por qué van a retirar estas versiones de la API?
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. Para poner las cosas en perspectiva, la versión 30 de la API provenía de nuestra versión Spring ‘14.

¿A qué afecta esta retirada de versiones de la API?
Esta retirada afecta a cualquier código, paquete, aplicación o integración que ejecuta una solicitud de las versiones 21.0 a la 30.0 de la API de SOAP, REST o masiva.

Nota: Esta retirada noafecta a lo siguiente:

• Versiones de API de clases de Apex, desencadenadores de Apex, páginas de Visualforce, flujos y generadores de procesos

• El producto B2B Classic/Visualforce listo para su uso

• Componentes de metadatos versionados en un paquete gestionado

• Los servicios web de REST y SOAP de Apex personalizados (un servicio web de Apex personalizado es una forma de hacer que un método de clase de Apex sea llamable como una API pública. Puede aprender más sobre las servicios web de Apex aquí: Servicios web de Apex)

¿Qué acciones tengo que realizar?

1. Identifique los componentes/aplicaciones en su organización que utilizan estas versiones heredadas de la API.

2. Actualice esos componentes/aplicaciones. Antes de la versión Summer '25 debe modificar o actualizar sus aplicaciones para que funcionen con las versiones de la API admitidas y vigentes. Salesforce recomienda encarecidamente pasarse a versiones más recientes de las API ya que le dan funciones avanzadas con seguridad y rendimiento mejorados.

Consulte la tabla a continuación para ver algunos lugares comunes de repercusión y qué acciones realizar para cada uno:

¿Cómo determino si se están utilizando versiones heredadas de la API en mis aplicaciones y dónde lo hacen?

Póngase en contacto con los desarrolladores de las aplicaciones que utiliza para determinar las versiones de API.

Además, puede revisar los eventos de API en el EventLogFile de uso total de la API que reporta actividad de la API de SOAP, REST y masiva desde Salesforce empleando uno de los dos métodos siguientes.

1. El primer método es utilizar el nuevo Explorador de registros de eventos incluido con la versión Summer ‘24.  Con él puede examinar los archivos de registro de eventos de Uso total de la API, y descargarlos como archivos CSV para ver los eventos de API individuales.

Desde Configuración, navegue a Seguridad → Supervisor de eventos → Navegador de registros de eventos.  Aquí puede ver los archivos de registros de eventos de las últimas 24 horas (o de los últimos 30 días si activó Supervisión de eventos).  Puede descargar los archivos de registros de eventos individuales como archivos CSV para ver los eventos de API en ellos.

2. De manera alternativa, el segundo método es utilizar un cliente como Salesforce CLI para ejecutar una consulta SOQL en el objeto EventLogFile, lo que le proporcionará archivos de registros de eventos de las últimas 24 horas (o 30 días si tiene Supervisión de eventos activada).

sf data query -q "SELECT Id, LogFile, EventType, CreatedDate FROM EventLogFile WHERE EventType IN ('ApiTotalUsage')" -o <su-nombreusuario>

Para cada resultado, realice una solicitud de la API de REST a los extremos del resultado de la consulta para recuperar los datos de registro de evento en ese archivo de registro de eventos.*

/services/data/v58.0/sobjects/EventLogFile/0AT3i000005vXpWGAU/LogFile

Pegue el cuerpo de la respuesta en una aplicación para inspeccionar fácilmente 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 30 e inferiores de la API.

Revise todos los eventos (ApiTotalUsage EventType) con API_VERSION de 30 e inferiores**

4. Para cualquier integración o cliente que consuma las versiones 30.0 y anteriores, siga las pistas proporcionadas por los campos clave en los datos del registro de eventos para ayudar a identificar el origen de la llamada de la API heredada:

CLIENT_NAME, CONNECTED_APP_ID, ENTITY_NAME, USER_ID

Para obtener más información sobre Supervisión de eventos, realice el módulo de Trailhead Monitoreo de eventos.

*Para obtener información introductoria sobre la realización de una solicitud de API de REST, consulte este módulo de Trailhead Utilizar la API de REST.

**El tipo de evento “Uso total de API” consolida información de solicitud relevante entre las API de SOAP, REST y masiva, incluyendo información de versión. Consulte los detalles de definición de eventos aquí. Las organizaciones con capacidad de API tienen acceso libre a los archivos de registro de eventos de Uso total API con retención de datos de 1 día. Con Supervisión de eventos activada, puede acceder a este y otros tipos de archivo de registro de eventos con una retención de datos de 30 días.

También puede hacer lo siguiente para encontrar solicitudes de API masiva o inicios de sesión en la API de SOAP:

• Encontrar solicitudes de API masiva: 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”. Esta retirada de la API afectará a cualquier trabajo con un valor de 30.0 o inferior dentro del campo “Versión de API”.

• Encontrar los inicios de sesión de API de SOAP: Para la operación login() de SOAP, navegue a “Historial de inicios de sesión” dentro de Configuración y revise las entradas con “SOAP Enterprise” o “SOAP Partner” con Tipo de API. De manera alternativa, puede consultarse el sObject LoginHistory a través de SOQL. Cualquier entrada de inicio de sesión que muestre un valor de 30.0 o inferior dentro del campo “Versión de API” se verá afectado por esta retirada.

Nota: Los socios pueden aprovechar los Registros de uso de paquetes para obtener perspectivas sobre su consumo de las API desusadas.

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

Sobre las versiones de API más recientes admitidas, visite el sitio Salesforce Developers.

Sobre las API y la mensajería saliente:

• Fundamentos de la API de plataforma (Trailhead)

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

• Comprender la Mensajería saliente (Guía del desarrollador)

• API masiva(Guía del desarrollador)

• Presentación de la API REST (Guía del desarrollador)

  • “REST” cubre todas las API con los URI de extremo bajo /services/data/vXX.Y/ y /services/metadata/vXX.Y/ donde XX.Y es la versión de la API. Esto incluye la API de REST de Salesforce Platform “estándar” para que funcione con sObjects y registros, pero también con los siguientes recursos:

    • Desarrollador de API de metadatos

    • API de herramientas

    • API de Chatter/Connect

    • API de Consultar y Consultar todo

    • API de búsquedas

    • API de límites

    • API de inicio de sesión (también denominada como “Identity”)

• • • Observe los resultados de una solicitud de REST a GET /services/data/v30.0 o GET /services/metadata/v30.0 para comprender el recursos de nivel superior afectados cuando se retiren los extremos de v30.0 e inferiores.

Si desea más información sobre la retirada de esta API heredada, puede ver Una actualización importante sobre nuestro plan de retirada de las API heredadas.

Para una explicación de las versiones de API dirigida a administradores, escuche aquí el podcast (tiene algunos años, pero la información principal sigue vigente): Por qué las versiones de la API son importantes con Kris Harrison.

Aún necesito ayuda. ¿Qué puedo hacer a continuación?

• Pase por los recursos anteriores.

• Publique en Trailblazer Community.

• Cree un caso con el Servicio de asistencia de Salesforce a través de la Ayuda de Salesforce. Recuerde lo que ya intentó y dónde se atascó de manera que el Servicio de asistencia pueda ayudarle con la mayor eficiencia posible. **Tenga en cuenta que el Servicio de asistencia no puede actualizar las API heredadas en su organización.

Para ver todas las retiradas vigentes y pasadas, consulte Retirada de productos y funciones de Salesforce. Para obtener más información sobre el enfoque de Salesforce sobre la retirada de productos y funciones, lea nuestra Filosofía de la retirada de productos y funciones.