From 16fabb2bfb504ae6a105d91c231febd3475042d4 Mon Sep 17 00:00:00 2001
From: Vincent Casse <vincent.casse@corp.ovh.com>
Date: Mon, 11 Jan 2016 18:30:19 +0100
Subject: [PATCH] Add hosting get capabilities example

Signed-off-by: Vincent Casse <vincent.casse@corp.ovh.com>
---
 .../api_get_hosting_capacities.md             | 117 ++++++++++++++++++
 examples/hosting-getCapabilities/apiv6.php    |  25 ++++
 2 files changed, 142 insertions(+)
 create mode 100644 examples/hosting-getCapabilities/api_get_hosting_capacities.md
 create mode 100644 examples/hosting-getCapabilities/apiv6.php

diff --git a/examples/hosting-getCapabilities/api_get_hosting_capacities.md b/examples/hosting-getCapabilities/api_get_hosting_capacities.md
new file mode 100644
index 0000000..3026cc1
--- /dev/null
+++ b/examples/hosting-getCapabilities/api_get_hosting_capacities.md
@@ -0,0 +1,117 @@
+How to get web hosting capabilities using php wrapper?
+----------------------------------------------------
+
+This documentation will help you to get informations about your web hosting offer: limits, features availables... This documentation is the equivalent of [hostingGetCapabilities SoAPI](https://www.ovh.com/soapi/fr/?method=hostingGetCapabilities)
+
+## Requirements
+
+- Having PHP 5.2+
+- Having an hosting account
+
+## Download PHP wrapper
+
+- Download the latest release **with dependencies** on github: https://github.com/ovh/php-ovh/releases
+
+```bash
+# When this article was written, latest version is 1.1.2
+wget https://github.com/ovh/php-ovh/releases/download/v1.1.2/php-ovh-1.1.2-with-dependencies.tar.gz
+```
+
+- Extract it into a folder
+
+```bash
+tar xzvf php-ovh-1.1.2-with-dependencies.tar.gz 
+```
+
+- Create a new token
+You can create a new token using these url: [https://api.ovh.com/createToken/?GET=/hosting/web/my_domain&GET=/hosting/web/offerCapabilities](https://api.ovh.com/createToken/?GET=/hosting/web/my_domain&GET=/hosting/web/offerCapabilities). Keep application key, application secret and consumer key to complete the script.
+
+Be warn, this token is only validated for this script and for hosting called **my_domain**. Please replace **my_domain** by your web hosting reference!
+If you need a more generic token, you had to change right field.
+
+- Create php file to get capabilities in the folder 
+
+```php
+<?php
+require __DIR__ . '/vendor/autoload.php';
+use \Ovh\Api;
+
+// Informations about your application
+$applicationKey = "your_app_key";
+$applicationSecret = "your_app_secret";
+$consumer_key = "your_consumer_key";
+
+// Information about API and rights asked
+$endpoint = 'ovh-eu';
+
+// Information about your web hosting
+$web_hosting = 'my_domain';
+
+// Get servers list
+$conn = new Api(    $applicationKey,
+                    $applicationSecret,
+                    $endpoint,
+                    $consumer_key);
+$hosting = $conn->get('/hosting/web/' . $web_hosting );
+
+print_r( $conn->get('/hosting/web/offerCapabilities', array( 'offer' => $hosting['offer'] ) ) );
+
+?>
+```
+
+## Run php file
+
+```bash
+php getCapabilities.php
+```
+
+For instance, for pro2014 account, the answer is
+```
+Array
+(
+    [traffic] => 
+    [moduleOneClick] => 1
+    [privateDatabases] => Array
+        (
+        )
+
+    [extraUsers] => 1000
+    [databases] => Array
+        (
+            [0] => Array
+                (
+                    [quota] => Array
+                        (
+                            [unit] => MB
+                            [value] => 400
+                        )
+
+                    [type] => sqlPerso
+                    [available] => 3
+                )
+
+            [1] => Array
+                (
+                    [quota] => Array
+                        (
+                            [unit] => MB
+                            [value] => 2000
+                        )
+
+                    [type] => sqlPro
+                    [available] => 1
+                )
+
+        )
+
+    [ssh] => 1
+    [sitesRecommended] => 10
+    [attachedDomains] => 2000
+    [crontab] => 1
+)
+```
+
+## What's more?
+
+You can discover all hosting possibilities by using API console to show all available endpoints: [https://api.ovh.com/console](https://api.ovh.com/console)
+
diff --git a/examples/hosting-getCapabilities/apiv6.php b/examples/hosting-getCapabilities/apiv6.php
new file mode 100644
index 0000000..b30561c
--- /dev/null
+++ b/examples/hosting-getCapabilities/apiv6.php
@@ -0,0 +1,25 @@
+<?php
+require __DIR__ . '/vendor/autoload.php';
+use \Ovh\Api;
+
+// Informations about your application
+$applicationKey = "your_app_key";
+$applicationSecret = "your_app_secret";
+$consumer_key = "your_consumer_key";
+
+// Information about API and rights asked
+$endpoint = 'ovh-eu';
+
+// Information about your web hosting
+$web_hosting = 'my_domain';
+
+// Get servers list
+$conn = new Api(    $applicationKey,
+                    $applicationSecret,
+                    $endpoint,
+                    $consumer_key);
+$hosting = $conn->get('/hosting/web/' . $web_hosting );
+
+print_r( $conn->get('/hosting/web/offerCapabilities', array( 'offer' => $hosting['offer'] ) ) );
+
+?>