Master API

Informace pro manažery

Master API představuje rychlou, efektivní a pohodlnou on-line službu pro registraci a správu domén.

Výhody Master API

  • Zautomatizuje operace prováděné s doménami, takže správa doménového portfolia se tak stává pohodlnější, odpadá stereotypní vyplňování opakujících se položek do formulářů.
  • Redukuje čas potřebný na administraci, což vede k úspoře nákladů. Zavedením MAPI je možné uspořit podstatné množství účasti pracovní síly, takže lze snížit náklady na ni.
  • Předchází chybám lidského prvku, které se více či méně často vyskytují. Automatizací lze dosáhnout velmi nízkého až nulového procenta chybovosti.
  • Partnerům je služba poskytována neomezeně, tedy 24 hodin denně, 7 dní v týdnu, nejsou nastavena ani žádná omezení na počet požadavků za časovou jednotku.
  • Službu je možné vyzkoušet v testovacím rozhraní. Pokud máte zájem o přístup do tohoto rozhraní, pište na info[at-sign]generalregistry[dot-sign]cz.

Informace pro programátory

Master API je rozhraní pro automatizovanou on-line správu a registraci domén v systému Domain Master.
Master API je navrženo s ohledem na učinné použití a jednoduchou implementaci. V jediném HTTP požadavku je možné doménu zaregistrovat, prodloužit nebo transferovat.

Přikazy a odpovědi se v Master API zasílají ve formě textových zpráv ve formátu YAML na protokolu HTTP. Implementace tak nebude činit žádné problémy v jazycích jako Perl, Python, Ruby a pod. Aktuálně nabízíme klienta pro PHP.

Následující příklad demonstruje možnou implementaci registrace domény pomocí utility wget. Tento příkaz zaregistruje doménu v každém unixovém operačním systému. 


      wget -q --output-document=- --header='Content-Type: text/plain' \
      --user=GR:PLATCE --password=heslo_platce --post-data='---
      command: register cz domain
      params:
        domain: domenka.cz
        registrant: MAJITEL
        idacc: GR:PLATCE' \
      https://www.domainmaster.cz/masterapi/server.php

Přečtěte si dokumentaci k Master API

Master API: klient pro PHP

Pro PHP dodáváme hotového klienta. Implementuje se rychle a intuitivně. Následující příklad naznačuje jeho použití. 


<?
    require('client/miniyaml.inc');
    require('client/masterapi_client.inc');

    $client = new MasterApi_Client(array(
      "username"     => "GR:PLATCE",
      "password"     => "heslo_platce",
      "server_url"   => "https://www.domainmaster.cz/masterapi/server.php"
    ));

    $result = $client->sendCommand("register cz domain",array(
      "domain"       => "domenka.cz",
      "registrant"   => "MAJITEL",
      "idacc"        => "GR:PLATCE"
    ));

    if($result->isSuccess()){
      echo 'domena byla zaregistrovana';
    }else{
      echo 'domena nebyla zaregistrovana, doslo k chybe: ', $result->getMessage(),"\n";
      if($result->isTemporaryError()){
        echo 'chyba je klasifikovana jako docasna, registraci muzeme opakovat pozdeji',"\n";
      }
    }
?>

Klienta pro PHP stahujte zde: