OVH API - Tout sur l'API du manager OVH

Ce site a été créé pour centraliser les informations relatives à l’API du manager OVH.

L’idée est d’avoir une liste complète des fonctions de l’API, et de regrouper exemples, projets, etc… Une des idées fortes est de promouvoir les commentaires sur chaque fonctions. Si vous avez découvert quelque chose à propos d’une fonction, etc… ajoutez un commentaire, partagez l’information avec tout le monde.

Vous pouvez trouver ici toutes les fonctions disponibles à la date d’aujourd’hui, même celles qui ne sont pas décrites dans la nouvelle documentation officielle. Au jour d’aujourd’hui, la documentation officielle, bien que tres bien faite, n’est pas complete, et ce site reste encore plus exhaustif.

Pour ceux qui veulent participer à la rédaction du site, pas de problèmes, envoyez moi un email. Nous recherchons des tutoriaux expliquant ce qu’est l’API, et comment commencer une simple implementation.

Bonjour,

Nous avons l’honneur de vous annoncer l’ouverture de notre site communautaire autour de l’api d’ovh.

http://www.bugkillers.eu

Vous y trouverez un module de gestion de mail OVH, un module de gestion de mailing list OVH et un module de gestion des redirections (ort et dyndns) OVH pour PHP-Nuke.
Le module OVH_MAIL (gestion des mails) a également été porté pour XOOPS 2.0.x

Les modules pour PHP-Nuke et Xoops sont respectivement en démonstration sur http://demonuke.bugkillers.eu (login et password en première page du site) et http://demoxoops.bugkillers.eu (login: demo, password: demo)

Bien à vous

Oli

Afin de bien débuter avec l’API d’OVH, Nicolas Merlet met gracieusement à votre disposition deux versions de son API.

La première version: ovhapi standard est destinée à une utilisation sur les mutualisés d’ovh. Elle utilise PEAR SOAP.

La seconde version ovhapi NuSOAP HTTPS est destinée à une utilisation sur un autre prestataire de service qu’OVH ou sur serveur dédié.

Exemples de réalisation avec l’API d’OVH Manager d’Olivier Debauche ( WeboT)

Certaines fonctions de l’api nécessitent l’envoi d’un tableau de hash en argument.
Les tableaux associatifs créés en PHP ne sont pas décodés de manière satisfaisante par le serveur api (PERL)
Pour créer des tableaux “décodables” par l’api l’astuce consiste à formater les tableaux associatifs à l’aide de soap_Value.

Voici un exemple d’appel de la fonction DomainDnsUpdate

dns est un tableau de hash :

[’dns’ => { ‘name’ => ‘DNS.OVH.NET’ , ‘ip’ => ‘xxx.xxx.xxx.xxx’ #facultative }, { ‘name’ => ‘NS.OVH.NET’}, … ]

< ?php
$dns = array();
$dns2 = array();
$dns[0] = new SOAP_value ( ‘’ , ‘’ , array("name” => $_POST[’dns0′],"ip” => $_POST[’ip0′]));
$dns[1] = new SOAP_value ( ‘’ , ‘’ , array("name” => $_POST[’dns1′],"ip” => $_POST[’ip1′]));
$dns2[] = $dns[0];
$dns2[] = $dns[1];

$dns3 = new SOAP_value ( ‘dns’ , ‘’ , $dns2 ) ;

$res=domainDnsUpdate($_SESSION[’id_soap_session’],array("domain” => $_POST[’domain’],$dns3));

ir Olivier Debauche

• hostname
nsxxxxx.ovh.net

Renvoie l’historique des backdoor sur un dédié. Si il n’y a pas de backdoor la fonction renvoie un code 200.

Exemple:
————


Array
(
[0] => stdClass Object
(
[date_email] => 2005-05-12 17:00:42
[do_not_mail] =>
[status] => 5
[ip] => 213.186.45.33
[cmdline] => ./r0nin
[procname] => r0nin
[pid] => 25334
[date_start] => 2005-05-12 16:21:58
[id] => 329
[uid] => nobody
[date_end] => 2005-05-12 19:29:27
[active] => 0
[port] => 1666
[type] => backdoor
[date_today] => 2006-07-29 16:05:01
[exe] => /tmp/r0nin
)

[1] => stdClass Object
(
[date_email] => 0000-00-00 00:00:00
[do_not_mail] =>
[status] => 5
[ip] => 213.186.45.33
[cmdline] => ./bindz
[procname] => bindz
[pid] => 3325
[date_start] => 2005-05-21 17:28:20
[id] => 1023
[uid] => nobody
[date_end] => 2005-05-22 19:28:10
[active] => 0
[port] => 9865
[type] => backdoor
[date_today] => 2006-07-29 16:05:01
[exe] => /tmp/bindz
)
)

• domain

Renvoie les actions qui peuvent être excécutées sur le domaine

Renvoie un résumé complet sur les domaines

Comment installer le nécessaire pour faire fonctionner l’api sur son dédié?

http://www.bugkillers.eu/OVHAPI_Bugkillers_post_p_48.html

bien à vous

WeboT

Depuis quelques semaines, de nombreux utilisateurs se sont enregistrés sur le site. Bienvenue à tous dans le monde merveilleux de l’API OVH.

N’hésitez pas à laisser des commentaires sur les fonctions, et enrichir les informations présentes sur le site. Si vous avez du code ou des exemples d’implementations de l’API à partager, envoyez nous les. Ou bien si vous êtes prêts à écrire de la documentation, des tutoriaux, etc… n’hésitez pas une seconde.

• domain
• pop
• size
[25000000|50000000|100000000|250000000 |500000000|1000000000|1500000000 |2000000000]

Permet d’upgrader le quota d’un pop

Un grand merci à Olivier webot Debauche pour ses constantes mises à jour du site. Sans lui, on serait autant à jour que la doc officielle ;)

Vous pouvez maintenant ajouter OVHAPI dans la liste des moteurs de recherche de Mozilla/Firefox. Tapez juste le nom d’une fonction, et vous serez redirigé sur la page de la fonction dans le site OVHAPI. Tapez autre chose, et vous aurez les résultats de la recherche sur tout le site.

Un projet de documentation pour l’API OVH est en train d’être créé. Nous recherchons des contributeurs pour nous aider à mettre en forme la doc, et l’écrire.

Si vous avez un peu de temps à consacrer à la doc, cela serait superbe.

Nous recherchons aussi des exemples de code, par exemple:

• Différentes implémentations SOAP
• Exemples simples de code utilisant l’API
• Implémentation avec différents langages (PHP, Perl, Java…)

Si vous avez des bouts de code, envoyez les moi. Tout matériel publié sur le site doit être open source (GPL pour le code ou GFDL pour la doc).

Merci pour votre aide à tous.

Vous pouvez accéder directement à la page d’une fonction en tapant:
http://www.verot.org/ovhapi/fonctionname
Remplacez fonctionname par le nom de la fonction, avec ou sans majuscules.
Par exemple: EmailDomainsSummary

Je viens de rajouter toutes les fonctions non documentées dans la doc officielle. Il me manque des paramètres pour certaines. (fonctions pour les hosts et ORT surtout). N’hésitez pas à ajouter vos informations.

J’ai aussi commenté certaines fonctions d’après les remarques faites sur bugkillers@

• domain
• redirected
• target
• target_old
• nic
• subdomain optionnel

Modifie une redirection email

• domainReferer
• componentReferer
[HOSTING|DEDICATED]

Renvoit la liste des freedom par service

• domain

Renvoit la liste des services / contacts du domaine

• domain
• module_type
[punbb|spip|mambo]
• password
• relative_target
• url
• subdomain
• multidomain

Crée un module

• domain

Déverrouille un domaine

note: non applicable au .be et .fr