add docs for custom URLs

Author: jenschude

commercetools/internal-docs/src/main/java/com/commercetools/docs/meta/Configuration.java

@@ -23,6 +23,12 @@
  *
  * {@include.example example.ImportExamplesTest#instance()}
  *
+ * <h3 id="custom-urls">Custom URLs</h3>
+ *
+ * To use custom URLs for API endpoints and authentication you have to provide the base URIs to the defaultClient method
+ *
+ * {@include.example example.ImportExamplesTest#customUrls()}
+ *
  * <h3 id="custom-client">Custom HTTP client</h3>
  *
  * <p>The builder can be instantiated with a custom {@link io.vrap.rmf.base.client.VrapHttpClient} instance. For example a

commercetools/internal-docs/src/test/java/example/ExamplesTest.java

@@ -79,6 +79,38 @@ public void instance() {
                         .build(),
                     ServiceRegion.GCP_EUROPE_WEST1)
                 .build("my-project");
+
+        // Project scoped ApiRoot config for Europe projects
+        ProjectApiRoot projectApiRootGcpEu = ApiRootBuilder.of()
+                .defaultClient(ClientCredentials.of()
+                        .withClientId("your-client-id")
+                        .withClientSecret("your-client-secret")
+                        .build(),
+                    ServiceRegion.valueOf("GCP_EUROPE_WEST1"))
+                .build("my-project");
+    }
+
+    public void customUrls() {
+        // Project scoped ApiRoot config using ServiceRegion class
+        ProjectApiRoot projectApiRoot = ApiRootBuilder.of()
+                .defaultClient(
+                    ClientCredentials.of()
+                            .withClientId("your-client-id")
+                            .withClientSecret("your-client-secret")
+                            .build(),
+                    ServiceRegion.GCP_EUROPE_WEST1.getOAuthTokenUrl(), ServiceRegion.GCP_EUROPE_WEST1.getApiUrl())
+                .build("my-project");
+
+        // Project scoped ApiRoot config using URI strings
+        ProjectApiRoot projectApiRoot2 = ApiRootBuilder.of()
+                .defaultClient(
+                    ClientCredentials.of()
+                            .withClientId("your-client-id")
+                            .withClientSecret("your-client-secret")
+                            .build(),
+                    "https://auth.europe-west1.gcp.commercetools.com/oauth/token",
+                    "https://api.europe-west1.gcp.commercetools.com/")
+                .build("my-project");
     }
 
     public void timeoutMiddleware() {