This example demonstrates how to use Camel’s REST DSL to expose a RESTful API and expose it to 3scale.

This example relies on the Openshift Maven plugin for its build configuration and uses the fabric8 Java base image.

The Openshift Maven Plugin discovers service metadata from Camel XML Context’s service definition and exposes the following:

You can run this quickstart in the following modes:

• Kubernetes / Single-node OpenShift cluster

• Standalone on your machine

The most effective way to run this quickstart is to deploy and run the project on OpenShift.

For more details about running this quickstart on a single-node OpenShift cluster, CI/CD deployments, as well as the rest of the runtime, see the Spring Boot Runtime Guide.

A single-node Kubernetes/OpenShift cluster provides you with access to a cloud environment that is similar to a production environment.

If you have a single-node Kubernetes/OpenShift cluster, such as Minishift or the Red Hat Container Development Kit, installed and running, you can deploy your quickstart there.

1. Log in to your OpenShift cluster:

   $ oc login -u developer -p developer

2. Create a new OpenShift project for the quickstart:

   $ oc new-project MY_PROJECT_NAME

3. Change the directory to the folder that contains the extracted quickstart application (for example, my_openshift/spring-boot-camel-rest-3scale) :

   or

   $ cd my_openshift/spring-boot-camel-rest-3scale

4. Build and deploy the project to the OpenShift cluster:

   $ mvn clean -DskipTests oc:deploy -Popenshift

5. In your browser, navigate to the MY_PROJECT_NAME project in the OpenShift console. Wait until you can see that the pod for the spring-boot-camel-rest-3scale has started up.

6. On the project’s Overview page, navigate to the details page deployment of the spring-boot-camel-rest-3scale application: https://OPENSHIFT_IP_ADDR:8443/console/project/MY_PROJECT_NAME/browse/pods/spring-boot-camel-rest-3scale-NUMBER_OF_DEPLOYMENT?tab=details.

7. Switch to tab Logs and then see the log from Camel.

When the example is running, a REST service is available to list users that have called this service. The user information comes from 3scale extensions to autofill API keys.

• "x-data-threescale-name": "app_ids" for the parameter that represents the application ID.

• "x-data-threescale-name": "app_keys" or "x-data-threescale-name": "user_keys" for the parameter that represents the application or user key.

Notice: As it depends on your OpenShift setup, the hostname (route) might vary. Verify with oc get routes which hostname is valid for you.

The actual endpoint is using the context-path camel-rest-3scale/users and the REST service provides two services:

• users/greet: to use 3scale API keys to add a user to this service’s list of calling users

• users/list: to list all users that have called the service

You can then access these services from your Web browser, e.g.:

• http://spring-boot-camel-rest-3scale-MY_PROJECT_NAME.OPENSHIFT_IP_ADDR.nip.io/camel-rest-3scale/users/greet

• http://spring-boot-camel-rest-3scale-MY_PROJECT_NAME.OPENSHIFT_IP_ADDR.nip.io/camel-rest-3scale/users/list

The example provides API documentation of the service using Swagger using the context-path camel-rest-3scale/api-doc. You can access the API documentation from your Web browser at http://spring-boot-camel-rest-3scale-MY_PROJECT_NAME.OPENSHIFT_IP_ADDR.nip.io/camel-rest-3scale/api-doc.

To run this quickstart as a standalone project on your local machine:

1. Download the project and extract the archive on your local filesystem.

2. Build the project:

   $ cd PROJECT_DIR
   $ mvn clean package

3. Run the service:

   $ mvn spring-boot:run

   Alternatively, you can run the application locally using the executable JAR produced:

   $ java -jar -Dspring.profiles.active=dev target/spring-boot-camel-rest-3scale-1.0-SNAPSHOT.jar

4. You can then access the REST API directly from your Web browser, e.g.:

   • http://localhost:8080/camel-rest-3scale/users/greet

   • http://localhost:8080/camel-rest-3scale/users/list