Crea un proxy en la interfaz de usuario de Apigee o mediante la API, tal como se describe en las siguientes secciones.
Campos principales de los proxies de API
Sigue estas directrices al crear un proxy de API:
Campo
Descripción
Nombre del proxy de API
Nombre que se muestra de tu API. Especifica caracteres alfanuméricos, guiones (-) o guiones bajos (_).
Ruta base del proxy de API
Fragmento de URI que aparece después de la dirección http://[host] o https://[host] de tu proxy de API. Apigee usa el URI de la ruta base para asociar y enrutar los mensajes de solicitud entrantes al proxy de API adecuado.
Usar comodines en rutas base
Usa uno o varios comodines en las rutas base de los proxies de API para que estos no queden obsoletos.
Permitimos especificar un solo carácter comodín * entre dos barras (/): /*/.
Por ejemplo, una ruta base /team/*/members permite que los clientes llamen a https://[host]/team/blue/members y https://[host]/team/green/members sin que tengas que crear nuevos proxies de API para admitir nuevos equipos.
Puedes sustituir cualquier número de tokens en la ruta base siguiendo este patrón.
No se admiten otros patrones, como /**, /something* o /*something.
Descripción
(Opcional) Descripción del proxy de API.
URL de destino o de backend
URL (incluidos HTTP o HTTPS) del servicio de backend que invoca este proxy de API.
Espacio
(Opcional) Si tu organización tiene habilitado Apigee Spaces, puedes asociar el proxy de API a un espacio.
Para obtener más información, consulta el artículo Introducción a los espacios de Apigee.
Pasos para crear un proxy de API
Para crear un proxy de API mediante la interfaz de usuario o las APIs, sigue estos pasos:
Apigee en la consola de Cloud
Para crear un proxy en Apigee en la consola de Cloud, sigue estos pasos:
En la Google Cloud consola, ve a la página Desarrollo de proxy > Proxies de API.
En el panel Crear un proxy, en Plantilla de proxy,
selecciona Proxy inverso (el más habitual).
En Detalles del proxy, introduce lo siguiente:
Nombre del proxy: introduce un nombre para el proxy, como myproxy.
Ruta base: se asigna automáticamente el valor que introduzcas en Proxy name. La ruta base forma parte de la URL que se usa para enviar solicitudes a tu API. Apigee usa la URL para
hacer coincidir y enrutar las solicitudes entrantes al proxy de API adecuado.
Descripción (opcional): introduce una descripción para el nuevo proxy de API, como "Prueba de Apigee con un proxy sencillo".
Destino (API actual): introduce https://mocktarget.apigee.net.
Define la URL de destino que invoca Apigee en una solicitud al proxy de API. El servicio mocktarget está alojado en Apigee y devuelve datos sencillos. No requiere ninguna clave de API ni token de acceso.
Espacio (opcional): si tu organización tiene habilitado Apigee Spaces, puedes asociar el proxy de API con un espacio seleccionado de la lista de opciones disponibles.
Para obtener más información, consulta el artículo Introducción a los espacios de Apigee.
Haz clic en Siguiente.
Implementar (opcional):
Entornos de implementación: opcional. Utilice las casillas de verificación para seleccionar uno o varios entornos en los que implementar su proxy. Si prefieres no implementar el proxy en este momento, deja el campo Entornos de implementación vacío. Puedes implementar el proxy más adelante.
Cuenta de servicio: opcional. Asocia una cuenta de servicio a tu implementación para que tu proxy pueda acceder a los servicios, tal como se especifica en el rol y los permisos de la cuenta de servicio. Google Cloud
Haz clic en Crear.
Apigee crea el nuevo proxy y muestra un resumen de los detalles del proxy en la vista Resumen del proxy.
Si decides implementar el proxy, en la sección Implementaciones se muestra el número de Revisión, que es 1 cuando lo implementas por primera vez. En la columna Estado se muestran los entornos en los que se ha implementado el proxy con un indicador de estado verde.
Apigee Classic
Para crear un proxy de API sencillo en la interfaz de usuario clásica de Apigee, sigue estos pasos:
En la vista principal, haz clic en Proxies de API.
En la lista desplegable Entorno, selecciona el entorno en el que quieras crear un proxy de API.
La interfaz de usuario híbrida muestra una lista de proxies de API de ese entorno. Si aún no has creado ningún proxy, la lista estará vacía.
Haz clic en Crear.
Se inicia el asistente para crear proxy.
Haz clic en Proxy inverso (la opción más habitual).
Se mostrará la página Detalles del proxy.
Configura tu proxy con los siguientes ajustes:
Nombre: escribe getstarted. Si ya existe un proxy con este nombre,
elige otro.
Ruta base: deja este campo con el valor /getstarted. La ruta base forma parte de la URL que se usa para enviar solicitudes a tu API. Apigee usa la URL para
hacer coincidir y enrutar las solicitudes entrantes al proxy de API adecuado.
Descripción (opcional): introduce una descripción para el nuevo proxy de API, como Get started API proxy.
Destino (API actual): introduce https://mocktarget.apigee.net. Define la URL de destino que invoca Apigee en una solicitud al proxy de API. El servicio mocktarget está alojado en Apigee y devuelve datos sencillos. No requiere ninguna clave de API ni token de acceso.
Los detalles de tu proxy de API deberían ser similares a los siguientes:
Haz clic en Siguiente.
En la vista Políticas comunes, en Seguridad:
Autorización, selecciona Transferencia (sin autorización).
Haz clic en Siguiente.
En la página Resumen, selecciona los entornos de implementación que quieras y haz clic en Crear e implementar.
Se crea y se despliega el nuevo proxy de API en el entorno seleccionado.
Haz clic en Editar proxy para mostrar la pestaña Información general en el editor de proxy.
En la lista de proxies de API, el getstarted estado de despliegue del proxy de API es verde en el entorno test.
API de Apigee
Crea un proxy de API en tu organización de Apigee enviando una solicitud POST
al siguiente recurso:
Debes definir el nombre del proxy de API mediante el parámetro de consulta name. Restringe los caracteres que se pueden usar en el nombre a los siguientes: A-Za-z0-9._\-$ %.
También puede importar un paquete de configuración de proxy de API siguiendo estos pasos:
Asigna el valor import al parámetro de consulta action.
Asigna el valor multipart/form-data al encabezado Content-type.
Indica el nombre del paquete de configuración del proxy de API en tu sistema de archivos local.
En el siguiente ejemplo se muestra cómo crear un proxy de API importando un paquete de configuración de proxy de API (helloworld-config.zip) en el sistema de archivos local mediante la API.
Para obtener más información sobre cómo crear un proxy de API, consulta el método apis.create
de la API de Apigee. Para ver todos los métodos disponibles para los proxies de API, consulta la API de proxies de API.
Pasos siguientes
Después de crear un proxy de API sencillo, normalmente se hace una de las siguientes acciones:
[[["Es fácil de entender","easyToUnderstand","thumb-up"],["Me ofreció una solución al problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Es difícil de entender","hardToUnderstand","thumb-down"],["La información o el código de muestra no son correctos","incorrectInformationOrSampleCode","thumb-down"],["Me faltan las muestras o la información que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-11 (UTC)."],[[["\u003cp\u003eThis page outlines the process of creating API proxies in Apigee and Apigee hybrid, which includes instructions for using the Apigee UI, API, and Cloud console.\u003c/p\u003e\n"],["\u003cp\u003eWhen creating an API proxy, key fields include the proxy name, which must be unique within the organization and consist of alphanumeric characters, dashes, or underscores, and the base path, which defines the URI for routing incoming requests, and must also be unique.\u003c/p\u003e\n"],["\u003cp\u003eWildcards (\u003ccode\u003e/*/\u003c/code\u003e) can be used in API proxy base paths to allow flexibility for future expansions without creating new API proxies, such as \u003ccode\u003ehttps://[host]/team/blue/members\u003c/code\u003e and \u003ccode\u003ehttps://[host]/team/green/members\u003c/code\u003e from basepath \u003ccode\u003e/team/*/members\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eAPI proxies can be created through the Apigee UI in the Cloud console or the classic Apigee UI, and by sending a POST request to the Apigee API, offering flexibility in proxy creation methods.\u003c/p\u003e\n"],["\u003cp\u003eAfter creating a simple API proxy, you can add policies, security, and other features of the Apigee platform, as well as deploy it to your cluster.\u003c/p\u003e\n"]]],[],null,["# Creating an API proxy\n\n*This page\napplies to **Apigee** and **Apigee hybrid**.*\n\n\n*View [Apigee Edge](https://docs.apigee.com/api-platform/get-started/what-apigee-edge) documentation.*\n\n| **Note:** In environments enabled for [archive deployments](/apigee/docs/api-platform/fundamentals/environments-overview#deployment-types), you cannot develop API proxies using the Apigee UI, API, or gcloud. To develop API proxies for archive deployments using Apigee in VS Code,see [Developing API proxies](/apigee/docs/api-platform/local-development/vscode/develop-apiproxies) using Apigee in VS Code.\n\nCreate a proxy in the Apigee UI, or using the API, as described in the following sections.\n\nAPI proxy primary fields\n------------------------\n\nFollow these guidelines when creating an API proxy:\n\nSteps to create an API proxy\n----------------------------\n\nTo create an API proxy using the UI or APIs: \n\n### Apigee in Cloud console\n\nTo create a proxy in Apigee in Cloud console:\n\n1. In the Google Cloud console, go to the **Proxy development \\\u003e API proxies** page.\n\n [Go to API proxies](https://console.cloud.google.com/apigee/proxies)\n| **Note:** If you see the **Welcome to Apigee API Management** page, you need to [provision\n| your Apigee organization](/apigee/docs/api-platform/get-started/provisioning-intro) before proceeding further.\n|\n| \u003cbr /\u003e\n|\n| After you have provisioned Apigee, close the UI and reopen the\n| [Apigee UI in Cloud console](https://console.cloud.google.com/apigee).\n2. In the **API Proxies** pane, click **+ Create**.\n3. In the **Create a proxy** pane, under **Proxy template** , select **Reverse proxy (Most common)**.\n4. Under **Proxy details** , enter the following:\n - **Proxy name:** Enter a name for the proxy, such as `myproxy`.\n - **Base Path** : Automatically set to the value you enter for `Proxy name`. The **Base\n Path** is part of the URL used to make requests to your API. Apigee uses the URL to match and route incoming requests to the appropriate API proxy.\n - **Description (Optional)**: Enter a description for your new API proxy, such as \"Testing Apigee with a simple proxy.\"\n - **Target (Existing API):** Enter `https://mocktarget.apigee.net`. This defines the target URL that Apigee invokes on a request to the API proxy. The mocktarget service is hosted at Apigee and returns simple data. It requires no API key or access token.\n - **Space (Optional)** : If your organization has Apigee Spaces enabled, you can associate the API proxy with a Space selected from the list of available options. For more information, see [Apigee Spaces overview](/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).\n - Click **Next**.\n5. **Deploy (optional)** :\n - **Deployment environments** : Optional. Use the checkboxes to select one or more environments in which to deploy your proxy. If you prefer not to deploy the proxy at this point, leave the **Deployment environments** field empty. You can always deploy the proxy later.\n - **Service Account**: Optional. Attach a service account to your deployment to enable your proxy to access Google Cloud services, as specified in the service account's role and permissions.\n6. Click **Create**.\n\nApigee creates the new proxy and displays a summary of the proxy details in the\n**Proxy summary** view.\n\nIf you choose to deploy the proxy, the **Deployments** section displays the **Revision**\nnumber, which is 1 when you first deploy. The **Status** column displays the\nenvironments in which the proxy is deployed with a green status indicator.\n\n### Classic Apigee\n\nTo create a simple API proxy in the classic Apigee UI:\n\n1. Sign in to the [Apigee UI](https://apigee.google.com).\n2. Click **API Proxies** in the main view.\n3. From the **Environment** drop-down list, select the environment in which you want to create a new API proxy.\n\n The hybrid UI displays a list of API proxies for that environment. If you haven't created any\n proxies yet, the list is empty.\n4. Click **Create New** .\n\n The Create Proxy wizard starts.\n5. Click **Reverse proxy (most common)** .\n\n The **Proxy details** page is displayed.\n6. Configure your proxy with the following settings:\n - **Name:** Enter `getstarted`. If a proxy already exists with this name, choose a different name.\n - **Base Path:** Leave this set to `/getstarted`. The **Base\n Path** is part of the URL used to make requests to your API. Apigee uses the URL to match and route incoming requests to the appropriate API proxy.\n - **Description** (Optional): Enter a description for your new API proxy, such as `Get started API proxy`.\n - **Target (Existing API):** Enter `https://mocktarget.apigee.net`. This defines the target URL that Apigee invokes on a request to the API proxy. The mocktarget service is hosted at Apigee and returns simple data. It requires no API key or access token.\n\n Your API proxy's details should look like the following:\n\n7. Click **Next**.\n8. In the **Common policies** view, under **Security:\n Authorization** select **Pass through (no authorization)** .\n\n9. Click **Next**.\n10. On the **Summary** page, select the deployment environments, if desired, and click **Create and deploy** .\n\n | **Note:** If you don't select an environment below **Optional Deployment** , the button at the lower right is just labeled **Create**.\n | **Note:** After you deploy an API proxy revision, you cannot edit it. To edit the API proxy, you must create and deploy a new revision.\n |\n | For this reason, you may choose to create the API proxy without deploying it to any\n | environment. You can edit the API proxy and deploy the API proxy later, as described in\n | [Next steps](#next-steps).\n\n Your new API proxy is created\n and deployed in the selected environment.\n\n11. Click **Edit proxy** to display the Overview tab in the Proxy Editor.\n12. \n\n\nIn the API proxies list, the `getstarted` API proxy deployment status is **green** for the `test` environment.\n\n### Apigee API\n\nCreate an API proxy in your Apigee organization by issuing a `POST`\nrequest to the following resource: \n\n```\nhttps://apigee.googleapis.com/v1/organizations/$ORG/apis\n```\n\nYou must define the name of the API proxy using the `name` query parameter. Restrict\nthe characters used in the name to the following: `A-Za-z0-9._\\-$ %`\n\nOptionally, you can import an API proxy configuration bundle by performing the following steps:\n\n- Set the `action` query parameter to `import`\n- Set the `Content-type` header to `multipart/form-data`\n- Pass the name of the API proxy configuration bundle on your local file system\n\nThe following example demonstrates how to create an API proxy by importing an API proxy\nconfiguration bundle (`helloworld-config.zip`) on your local file system using the\nAPI. \n\n```\ncurl \"https://apigee.googleapis.com/v1/organizations/$ORG/apis?name=helloworld&action=import\" \\\n -X POST \\\n -H \"Authorization: Bearer $TOKEN\" \\\n -H \"Content-type: multipart/form-data\" \\\n -F \"file=@helloworld-config.zip\"\n```\n\nWhere `$TOKEN` is set to your OAuth 2.0 access token, as described in\n[Obtaining an OAuth 2.0 access token](/apigee/docs/api-platform/get-started/api-get-started#oauth20). For information about the `curl` options used in this example, see\n[Using curl](/apigee/docs/api-platform/get-started/api-get-started#curl). For a description of environment variables you can use, see\n[Setting\nenvironment variables for Apigee API requests](/apigee/docs/api-platform/get-started/api-get-started#api-environment-variables).\n\nThe following provides an example of the response output: \n\n```carbon\n{\n \"basepaths\": [\n \"/helloworld\"\n ],\n \"configurationVersion\": {\n \"majorVersion\": 4\n },\n \"createdAt\": \"1559145292799\",\n \"displayName\": \"helloworld\",\n \"entityMetaDataAsProperties\": {\n \"bundle_type\": \"zip\",\n \"subType\": \"Proxy\",\n \"lastModifiedAt\": \"1559145292799\",\n \"createdAt\": \"1559145292799\"\n },\n \"lastModifiedAt\": \"1559145292799\",\n \"name\": \"helloworld\",\n \"policies\": [\n \"verify-api-key\",\n \"remove-query-param-apikey\",\n \"OAuth-v20-1\"\n ],\n \"proxies\": [\n \"default\"\n ],\n \"proxyEndpoints\": [\n \"default\"\n ],\n \"resourceFiles\": {},\n \"targetEndpoints\": [\n \"default\"\n ],\n \"targets\": [\n \"default\"\n ],\n \"type\": \"Application\",\n \"revision\": \"1\",\n \"description\": \"Hello world\"\n}\n```\n\nFor more information on creating an API proxy, see the [`apis.create` method](/apigee/docs/reference/apis/apigee/rest/v1/organizations.apis/create)\nin the Apigee API. To see all the methods available for API proxies, see the [API proxies API](/apigee/docs/reference/apis/apigee/rest/v1/organizations.apis).\n\nNext steps\n----------\n\nAfter you create a simple API proxy, you typically do one of the following:\n\n- Add policies, security, and other features of the Apigee platform, as described in [Understanding APIs and\n API proxies](/apigee/docs/api-platform/fundamentals/understanding-apis-and-api-proxies).\n- Deploy it to your cluster, as described in [Deploy an API proxy](/apigee/docs/api-platform/deploy/ui-deploy-new)."]]
