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.
  • Pokud jste v našem systému registrován jako plátce, službu je možné vyzkoušet v testovacím rozhraní. Pro využívání služby v produkčním rozhraní je potřeba mít uzavřenu partnerskou smlouvu. Pro více informací pište na info[at-sign]generalregistry[dot-sign]cz.
  • Kompletní podmínky k využití Master API naleznete v tomto dokumentu: Conditions for using the MasterAPI automated interface

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 JSON nebo YAML na protokolu HTTP. Implementace tak nebude činit žádné problémy v jazycích jako Perl, Python, Ruby, C# 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' \
      https://www.domainmaster.cz/masterapi/server.php \
      --user=GR:PLATCE --password=heslo_platce --post-data='{
        "command": "register cz domain",
        "params": {
          "domain": "domenka.cz",
          "registrant": "MAJITEL",
          "idacc": "GR:PLATCE"
        }
      }'
    

V případě, že bude příkaz proveden úspěšně, vrátí Master API tuto odpověď:

      {"status":"success","message":"Ok"}

Read the Master API documentation

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í.


<?php
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: