Paso 4: Probar la API

Esta página se aplica a Apigee y Apigee Hybrid.

Consulta la documentación de Apigee Edge.

Para probar la API de helloworld implementada, haz clic en la pestaña Terminal en Apigee en Cloud Code y, luego, ingresa la siguiente llamada curl:

curl 0:8998/helloworld

Se muestra el siguiente mensaje de error:

Llama a la API en la pestaña de la terminal y obtiene un error de autorización

Dado que habilitaste la autenticación basada en claves de API cuando creaste el proxy de API, debes pasar una clave de API mediante el parámetro de búsqueda apikey cuando llamas a la API.

Para obtener una clave de API, debes crear un paquete de prueba y configurar los siguientes recursos de prueba:

  • Producto de API que se usa para agrupar la API y hacer que esté disponible para los desarrolladores

  • Desarrollador que creará una app para acceder a la API

  • App de desarrollador que habilitará el acceso a la API mediante una clave de API

Compila y exporta recursos de prueba, obtén la clave de API y vuelve a probar tu API.

  1. Crea un paquete de prueba:
    1. Coloca el cursor sobre la carpeta pruebas en la sección de Apigee y haz clic en Crear ícono.

      Se muestra + cuando colocas el cursor sobre la carpeta de pruebas

      Se abrirá el asistente para crear un paquete de prueba.

    2. Ingresa mytestbundle para el nombre del paquete de prueba y presiona Intro.

      Se creó el paquete de prueba.

    3. Expande la carpeta mytestbundle en la sección de Apigee para ver su contenido.

      Carpeta de prueba con archivos developerapps.json, developer.json, maps.json y de products.json

  2. Configura el recurso de prueba del producto de la API:
    1. Coloca el cursor sobre el archivo products.json en la sección de Apigee y haz clic en Crear ícono.

      + se muestra cuando colocas el cursor sobre products.json

      Se abrirá el asistente para crear productos de API.

      Primera página del asistente para crear productos de API

    2. Ingrese myproduct para el nombre del producto de la API y presione Intro para confirmar y continuar.
    3. Ingrese myproduct para la descripción del producto de la API y presione Intro para confirmar y continuar.
    4. Selecciona helloworld para agregar el proxy de API al producto de API y haz clic en Aceptar.

      El archivo products.json se abre en el editor con el nuevo producto de API configurado, como se muestra a continuación:

      [
        {
          "attributes": [
            {
              "name": "sample_attribute_0",
              "value": "sample_attribute_value_0"
            }
          ],
          "scopes": [],
          "environments": [],
          "apiResources": [
            "/",
            "/*",
            "/**"
          ],
          "quota": "100",
          "quotaInterval": "1",
          "quotaTimeUnit": "minute",
          "name": "myproduct",
          "displayName": "myproduct",
          "proxies": [
            "helloworld"
          ]
        }
      ]
  3. Configura el recurso de prueba para desarrolladores:
    1. Coloca el cursor sobre el archivo developers.json en la sección de Apigee y haz clic en Crear ícono.

      + se muestra cuando colocas el cursor sobre desarrolladores.json

      Se abrirá el asistente de creación de desarrolladores.

      Primera página del asistente para crear productos de API

    2. Ingresa los siguientes valores en los mensajes y presiona Intro para confirmar y continuar:
      • Correo electrónico del desarrollador: ahamilton@example.com
      • Nombre de usuario: ahamilton
      • Nombre: Alex
      • Apellido: Hamilton

      El archivo developers.json se abre en el editor con el nuevo desarrollador configurado, como se muestra a continuación:

      [
        {
          "attributes": [
            {
              "name": "sample_attribute_0",
              "value": "sample_attribute_value_0"
            }
          ],
          "email": "ahamilton@example.com",
          "userName": "ahamilton",
          "firstName": "Alex",
          "lastName": "Hamilton"
        }
      ]
  4. Configura el recurso de prueba de la app para desarrolladores:
    1. Coloca el cursor sobre el archivo developerapps.json en la sección de Apigee y haz clic en Crear ícono.

      + se muestra cuando colocas el cursor sobre developerapps.json

      Se abrirá el asistente para crear una app de desarrollador.

      Primera página del asistente para crear productos de API

    2. Selecciona ahamilton@example.com como el propietario de la app.
    3. Ingresa los siguientes valores en el siguiente conjunto de mensajes y presiona Intro para confirmar y continuar:
      • Nombre de la aplicación: myapp
      • Descripción: myapp
      • URL de devolución de llamada: dejar en blanco
    4. Selecciona myproduct para agregarlo a la app y haz clic en OK.
    5. Selecciona nunca para el valor de vencimiento.

      El archivo developerapps.json se abre en el editor con la nueva aplicación configurada, como se muestra a continuación:

      [
        {
          "attributes": [
            {
              "name": "sample_attribute_0",
              "value": "sample_attribute_value_0"
            }
          ],
          "developerEmail": "ahamilton@example.com",
          "name": "myapp",
          "displayName": "myapp",
          "callbackUrl": "",
          "apiProducts": [
            "myproduct"
          ],
          "expiryType": "never"
        }
      ]
  5. Exporta los recursos de prueba al emulador de Apigee.

    En la sección de Apigee, coloca el cursor sobre el paquete de prueba mytestbundle y haz clic en Icono de exportación de la prueba.

    Recursos de prueba activos, que incluyen productos de API, desarrolladores y apps para desarrolladores

    Los recursos de prueba activos aparecen en la sección Emuladores de Apigee, como se muestra en la siguiente figura.

    Recursos de prueba activos, que incluyen productos de API, desarrolladores y apps para desarrolladores

  6. En la sección Emuladores de Apigee, en los recursos de prueba activos, haz clic en Apps para desarrolladores activas.

    El archivo de configuración de apps activo para desarrolladores se abre en el editor. El archivo contiene credenciales para myproduct, como se destaca en la siguiente figura.

    Apps de desarrolladores con el valor customerKey destacado.

  7. Copia el valor de consumerKey (sin comillas) para el producto de API myproduct.
  8. Pasa la clave de API en tu llamada a curl mediante el parámetro de búsqueda apikey de la siguiente manera:
    curl 0:8998/helloworld?apikey=ZQA5euYtNeJ7ZCGCJMpvd6F2BZOmxOzY

    Se muestra la siguiente respuesta:

    Hello, Guest!

¡Felicitaciones! Ejecutaste una API en tu entorno local de forma correcta.

En el siguiente paso, aprenderás cómo cambiar el extremo de destino.

Próximo paso

1 2 3 4 (SIGUIENTE) Paso 5: Cambia el extremo de destino 6 7 8