IBM API Connect

IBM® API Connect® is a complete, intuitive and scalable API platform that lets you create, expose, manage and monetize APIs across clouds. This means you and your customers can power digital applications and spur innovation.

Cloud CMS integrates with API Connect by providing an entry point to our API. You configure API Connect to expose the Cloud CMS API as a service and point your applications to this service instead of the normal https://api.cloudcms.com (SAAS clients) endpoint.

On-Premise customers can create a similar service by referencing their own Cloud CMS API server cluster entry point as an API service in API Connect. If your cluster is available externally then you can use IBM's Cloud service API Connect. If not then you may need to host your own API Connect servers. More information on hosting your own API Connect service can be found at IBM

Create a service for your Cloud CMS API in your IBM Cloud portal under "API Management" and "API Gateway". From "Services" create a new service. Under "Managed APIs" click "Create API" and choose "Create an API Proxy". This creates a new API Service which is a proxy to an existing API; In this case the Cloud CMS API (either SAAS or your own cluster).

Complete the configuration form:

API Name: Choose an appropriate name such as "Cloud Production CMS API"

Base path for API: Enter a unique path prefix for this API service such as "/cloudcms-prod-api"

External Endpoint: https://api.cloudcms.com (or your API cluster URL for on-premise customers)

Under "Security and Rate Limiting" disable "OAuth user authentication" as the CLoud CMS API is already protected by oAuth2.

"Rate Limiting" is optional. The Cloud CMS API server also supports rate limiting so you can use one or the other (or neither).

"CORS" is not necessary unless you plan to make API calls directly from a web browser which is not recommended.

Create the service and then go to the "Monitor" page. To test the new API Connect service, Copy the "Route" URL from "API Info". Paste this into a new browser window and append "/ping" to the url. The URL should look something like this:

https://245d159f.us-south.apigw.appdomain.cloud/cloud-prod-cms/ping

You should see a JSON object returned which describes the Cloud CMS API server version and some other metadata similar to this:

{
    "build":{
        "vendor":"Gitana Software, Inc.",
        "product":"Cloud CMS","version":"3.2.64",
        "build":"27c0bbcc3a65a0ecb1d46ad42642c2512a8f6c64",
        "timestamp":"08-Jul-2021 18:34:13"
    }
}

Configure Your Application

Now that your API is available as an API Connect service you simply need to make your Cloud CMS API calls against this new service instead of directly against the Cloud CMS API cluster.

This is usually as easy as updating the baseURL property in the gitana.json file used by your application. For example:

On-Premise Options

If you are running your own Cloud CMS API cluster then you may update the default baseURL which will be included in any new API key files (gitana.json) so that your new service is used automatically.

org.gitana.platform.services.apikeys.defaultBaseURL=https://api.cloudcms.com

See details in our API Server documentation