Merge pull request #1068 from appwrite/fix-endpoint

feat: endpoint for docs / examples

Author: christyjacob4

example.php

@@ -42,7 +42,7 @@ function getSSLPage($url) {
      $platform = 'console';
     // $platform = 'server';
 
-    $spec = getSSLPage("https://raw.githubusercontent.com/appwrite/appwrite/1.7.x/app/config/specs/swagger2-latest-{$platform}.json");
+    $spec = getSSLPage("https://raw.githubusercontent.com/appwrite/appwrite/1.6.x/app/config/specs/swagger2-latest-{$platform}.json");
 
     if(empty($spec)) {
         throw new Exception('Failed to fetch spec from Appwrite server');

src/SDK/SDK.php

@@ -544,6 +544,7 @@ public function generate(string $target): void
                 'namespace' => $this->spec->getNamespace(),
                 'version' => $this->spec->getVersion(),
                 'endpoint' => $this->spec->getEndpoint(),
+                'endpointDocs' => $this->spec->getEndpointDocs(),
                 'host' => parse_url($this->spec->getEndpoint(), PHP_URL_HOST),
                 'basePath' => $this->spec->getAttribute('basePath', ''),
                 'licenseName' => $this->spec->getLicenseName(),

src/Spec/Spec.php

@@ -64,6 +64,11 @@ abstract public function getVersion();
      */
     abstract public function getEndpoint();
 
+    /**
+     * @return string
+     */
+    abstract public function getEndpointDocs();
+
     /**
      * @return string
      */

src/Spec/Swagger2.php

@@ -48,6 +48,16 @@ public function getEndpoint()
         $this->getAttribute('basePath', '');
     }
 
+    /**
+     * @return string
+     */
+    public function getEndpointDocs()
+    {
+        return $this->getAttribute('schemes.0', 'https') .
+        '://' . $this->getAttribute('x-host-docs', 'example.com') .
+        $this->getAttribute('basePath', '');
+    }
+
     /**
      * @return string
      */

templates/android/docs/java/example.md.twig

@@ -23,7 +23,7 @@ import {{ sdk.namespace | caseDot }}.enums.{{ name | caseUcfirst }};
 
 Client client = new Client(context)
     {%~ if method.auth|length > 0 %}
-    .setEndpoint("https://cloud.appwrite.io/v1") // Your API Endpoint
+    .setEndpoint("{{ spec.endpointDocs | raw }}") // Your API Endpoint
     {%~ for node in method.auth %}
     {%~ for key,header in node|keys %}
     .set{{header | caseUcfirst}}("{{node[header]['x-appwrite']['demo'] | raw }}"){% if loop.last %};{% endif %} // {{ node[header].description }}

templates/android/docs/kotlin/example.md.twig

@@ -23,7 +23,7 @@ import {{ sdk.namespace | caseDot }}.enums.{{ name | caseUcfirst }}
 
 val client = Client(context)
     {%~ if method.auth|length > 0 %}
-    .setEndpoint("https://cloud.appwrite.io/v1") // Your API Endpoint
+    .setEndpoint("{{ spec.endpointDocs | raw }}") // Your API Endpoint
     {%~ for node in method.auth %}
     {%~ for key,header in node|keys %}
     .set{{header | caseUcfirst}}("{{node[header]['x-appwrite']['demo'] | raw }}") // {{node[header].description}}

templates/android/example/src/main/java/io/package/android/utils/Client.kt.twig

@@ -8,7 +8,7 @@ object Client {
 
     fun create(context: Context) {
         client = Client(context)
-            .setEndpoint("http://192.168.4.24/v1")
+            .setEndpoint("{{ spec.endpointDocs | raw }}")
             .setProject("65a8e2b4632c04b1f5da")
             .setSelfSigned(true)
     }

templates/dart/docs/example.md.twig

@@ -5,7 +5,7 @@ import 'package:{{ language.params.packageName }}/{{ language.params.packageName
 
 Client client = Client()
     {%~ if method.auth|length > 0 %}
-    .setEndpoint('https://cloud.appwrite.io/v1') // Your API Endpoint
+    .setEndpoint('{{ spec.endpointDocs | raw }}') // Your API Endpoint
     {%~ for node in method.auth %}
     {%~ for key,header in node|keys %}
     .set{{header}}('{{node[header]['x-appwrite']['demo'] | raw }}'){% if loop.last %};{% endif%} // {{node[header].description}}

templates/deno/docs/example.md.twig

@@ -2,7 +2,7 @@ import { Client, {{ service.name | caseUcfirst }}{% for parameter in method.para
 
 const client = new Client()
     {%~ if method.auth|length > 0 %}
-    .setEndpoint('https://cloud.appwrite.io/v1') // Your API Endpoint
+    .setEndpoint('{{ spec.endpointDocs | raw }}') // Your API Endpoint
     {%~ for node in method.auth %}
     {%~ for key,header in node|keys %}
     .set{{header}}('{{node[header]['x-appwrite']['demo'] | raw }}'){% if loop.last %};{% endif%} // {{node[header].description}}

templates/dotnet/docs/example.md.twig

@@ -11,7 +11,7 @@ using {{ spec.title | caseUcfirst }}.Services;
 
 Client client = new Client()
 {% if method.auth|length > 0 %}
-    .SetEndPoint("https://cloud.appwrite.io/v1") // Your API Endpoint
+    .SetEndPoint("{{ spec.endpointDocs | raw }}") // Your API Endpoint
 {% for node in method.auth %}
 {% for key,header in node|keys %}
     .Set{{header | caseUcfirst}}("{{node[header]['x-appwrite']['demo'] | raw }}"){% if loop.last %};{% endif %} // {{node[header].description}}