Step 3: Call your API proxy

Stay organized with collections Save and categorize content based on your preferences.

You're viewing Apigee X documentation.
View Apigee Edge documentation.

Now that you've created a new proxy, you're ready to test it by calling the proxy. To call the proxy, enter the following command:

curl -v https://YOUR_ENV_GROUP_HOSTNAME/myproxy

where YOUR_ENV_GROUP_HOSTNAME is the hostname for an environment group that contains the environment in which your proxy is deployed. See Find the environment group hostname.

A successful call to the proxy returns the following output:

Hello, Guest!

If you get an error, check the following:

  • If you see a timeout error (unusual), try undeploying and redeploying the new API proxy.
  • If the host cannot be resolved, for example you receive a 404 error, double check that you are using the correct hostname and proxy name. You can find the hostname in the Apigee UI. Go to Admin > Environments > Groups to view the hostname or hostnames.
  • If you see a TLS/SSL error, such as an SSL handshake error, contact your DNS provider to make sure the DNS A record for the hostname is configured properly. Make sure the record has the IP of the load balancer that was created during Apigee provisioning. If you're not sure what the IP should be, see Determining whether the Cloud Load Balancer is configured for a hostname.
  • If you see a TLS/SSL certificate error, the SSL certificate associated with the load balancer might not have the correct hostname, and therefore is being rejected. The certificate was created during the provisioning process. The troubleshooting steps in Determining whether the Cloud Load Balancer is configured for a hostname show you how to locate and inspect the certificate.
  • If you're unable to resolve the problem, contact the person who provisioned Apigee X for further assistance.

Find the environment group hostname

If you don't know the environment group hostname, you can find it as follows:

  1. In the Apigee UI, select Admin > Environments > Groups.
  2. Look for a row displaying the environment in which your proxy is deployed. For example, if the environment is my-environment, the row might appear as shown below:

    Environment groups pane in the Apigee UI.

    The environment group hostname for this environment is example.my-environment-group.

In this case, the curl command to call the proxy would be:

curl -v https://example.my-environment-group/myproxy

In the next step, you will change the target endpoint to return XML data from the target service.

Next step

1 2 3 (NEXT) Step 4: Change the target endpoint 5