Skip to main content
Únase a nosotros en TDX, en San Francisco, o en Salesforce+ los días 5 y 6 de marzo en la conferencia para desarrolladores sobre la era de agentes de IA. Registrarse ahora.

Configurar y conectar Postman

Nota

Nota

¿Su idioma de aprendizaje es español? Comience el reto en un Trailhead Playground en español y utilice las traducciones proporcionadas entre paréntesis para navegar. Copie y pegue solo los valores en inglés, ya que las validaciones del reto se basan en los datos en inglés. Si no aprueba el reto en su organización en español, le recomendamos que (1) cambie la configuración regional a Estados Unidos, (2) cambie el idioma a inglés, siga las instrucciones descritas aquí y, a continuación, (3) vuelva a hacer clic en el botón Check Challenge (Comprobar el reto).

Consulte la insignia Trailhead en su idioma para obtener más información sobre cómo aprovechar la experiencia de Trailhead en otros idiomas.

Registrarse en Postman y crear un espacio de trabajo

Postman ofrece dos opciones para trabajar con su aplicación: la versión de escritorio y la versión web. Para este proyecto, vamos a usar la aplicación de navegador web.

  1. Inicie sesión en su cuenta de Postman o regístrese para obtener una.
  2. Seleccione el menú Workspaces (Espacios de trabajo).
  3. Seleccione Create Workspace (Crear espacio de trabajo).
  4. Asigne el nombre SalesforceCollection al espacio de trabajo.
  5. Establezca Visibility (Visibilidad) como Personal (Personal).
  6. Haga clic en Create Workspace (Crear espacio de trabajo).

Crear una bifurcación para la colección de Salesforce

  1. Abra el espacio de trabajo Salesforce Developers para crear una bifurcación de la colección de API de Salesforce.
  2. En Collections (Colecciones), seleccione Salesforce Platform APIs (API de Salesforce Platform) para expandir la sección.
  3. Haga clic en Crear la bifurcación para crear una bifurcación de la colección.
  4. Introduzca MySalesforceAPIFork.
  5. Deje SalesforceCollection como el espacio de trabajo.
  6. Haga clic en Fork Collection (Generar bifurcación de la colección).

La colección ya está preparada en Postman. Vamos a usarla para autorizar su organización y probarla.

Autorizar su organización

Debe autenticarse con Salesforce para poder acceder a las API. Durante la autenticación se le concede un token de acceso que es válido durante un tiempo determinado. Repita este proceso siempre que el token caduque.

  1. Asegúrese de que ha iniciado sesión en un único Trailhead Playground en el navegador.
  2. En Postman, en Collections (Colecciones), debe aparecer seleccionada la colección Salesforce Platform APIs (API de Salesforce Platform).
  3. Compruebe que la opción No Environment (Sin entorno) está seleccionada.
  4. La ficha Authorization (Autorización) debe estar abierta.
  5. El tipo debe ser OAuth 2.0.
  6. Haga clic en Get New Access Token (Obtener un nuevo token de acceso).
Nota

Si no ha iniciado sesión en un Trailhead Playground u organización de Salesforce, se abre una pestaña del navegador con la pantalla de inicio de sesión de Salesforce. Escriba el nombre de usuario y la contraseña que guardó en el primer paso para iniciar sesión.

  1. Haga clic en Allow (Permitir) para permitir que la colección de API de Salesforce Platform para Postman acceda a su Trailhead Playground.
    En el cuadro de diálogo Allow Access? (¿Permitir acceso?), haga clic en Allow (Permitir) para permitir que la colección de API de Salesforce Platform para Postman acceda a su información básica y a sus datos, y que puede gestionar estos últimos, o bien haga clic en Deny (Denegar). Para revocar el acceso en cualquier momento, puede ir a sus ajustes personales.
  2. Aparece un mensaje breve de operación completada, y luego se le redirigirá al cuadro de diálogo Manage Access Tokens (Acceder a los tokens de acceso).
    En el cuadro Manage Access Tokens (Gestionar tokens de acceso), aparecen las opciones Token Name (Nombre del token), Access Token (Token de acceso), Token Type (Tipo de token), instance_url, issued_at, signature (firma) y scope (alcance).
  3. Compruebe que instance_url dirige a su Trailhead Playground.
  4. Copie el valor de instance_url para usarlo en el paso 12. Tenga cuidado de copiar únicamente la URL, sin caracteres adicionales.
  5. Haga clic en Use Token (Usar token).
  6. Abra la ficha Variables (Variables).
  7. En la fila _endpoint, en la columna CURRENT VALUE, pegue el valor de instance_url que ha copiado en el paso 9.
  8. Haga clic en Save (Guardar).

Una prueba de conexión rápida

Vamos a comprobar si la conexión funciona.

  1. En Collections (Colecciones), seleccione Salesforce Platform APIs (API de Salesforce Platform) para expandir la sección.
  2. Seleccione REST para expandir la sección.
  3. Seleccione GET Limits (Límites de GET).
    Los límites se abren en el panel principal.
  4. Haga clic en Send (Enviar).
    Ficha GET Limits (Límites de GET) de Postman donde se ve la respuesta en el panel principal. En Status (Estado), vemos "200 OK".
  5. Compruebe que el estado sea "200 OK".
    Es posible que tenga que activar la configuración Follow Authorization header (Seguir el encabezado de autorización) para conservar el encabezado de autorización cuando haya un redireccionamiento a un nombre de host distinto.
    Ajuste Follow Authorization header (Seguir el encabezado de autorización) en Get Request Settings (Configuración de solicitud GET)

Ya se ha autenticado con Salesforce. Ahora puede usar el resto de solicitudes de la colección.

Publicar una cuenta

Acaba de extraer algunos datos de la organización. Vamos a intentar agregar algunos datos nuevos en la organización.

  1. En REST, seleccione SObject y luego POST SObject Create (Crear SObject de solicitud POST).
  2. Abra la ficha Params (Parámetros).
  3. En Path Variables (Variables de la ruta), en la fila SOBJECT_API_NAME, columna VALUE, escriba Account (Cuenta).
  4. Abra la ficha Body (Cuerpo).
  5. Sustituya el texto del cuerpo por este código:
    {
      "Name": "Postman",
      "BillingState": "CA"
    }
  6. Haga clic en Save (Guardar).
  7. Haga clic en Send (Enviar).
    Postman devuelve el identificador de la nueva cuenta.
    Postman con el panel de creación de SObject en el panel principal, donde vemos los resultados tras sustituir el cuerpo y pulsar Send (Enviar). En Status (Estado), vemos "201 Created (201 creado)".
  8. Compruebe que el estado sea "201 Created (201 creado)".
Nota

Si no ve el estado "201 Created (201 creado)", es posible que haya iniciado sesión en otra organización. Compruebe que instance_url esté establecida en su Trailhead Playground.

  1. Abra el Playground autorizado.
  2. En App Launcher (“”), busque y seleccione Accounts (Cuentas).
  3. Compruebe que la nueva cuenta esté ahí.

Excelente. Ya ha configurado Postman para que interactúe con su organización. La colección Salesforce APIs for Postman (API de Salesforce para Postman) que ha cargado le ayudará en su misión de descubrir las API de Salesforce.

Recursos

Verificar paso

+100 puntos

Completará esta/este proyecto en su propia organización de prácticas. Haga clic en Iniciar para empezar a trabajar o haga clic en el nombre de su organización para seleccionar otro diferente.

Comparta sus comentarios sobre Trailhead en la Ayuda de Salesforce.

Nos encantaría conocer su experiencia con Trailhead. Ahora puede acceder al nuevo formulario de comentarios cuando quiera desde el sitio de la Ayuda de Salesforce.

Más información Continuar para compartir comentarios