API Actions

API endpiont URL: https://online.mhosting.hu/reseller/controller.php

Constant Parameters

Ezeket a Parametereket minden API kérésnél szükséges elküldeni

 

Parameter

Possible values

Description

api_action

 

Requested command

sld

domain-registration-test

Domain name (without TLD)

tld

hu

TLD

Username

 

Email of reseller

Password

Base64_encode(pass)

Password coded

SecretKey

 

Secret API key of reseller

valid_domain

domain without www

Domain name of the host which is enabled for the reseller account API access

valid_ip

 

IP address of the host which is enabled for the reseller account API access

 

 

 

Api_Action commands

registerdomain Register Domain
transferdomain Transfer Domain 
renewdomain Renew Domain
dailyupdate Get Domain Parameters (status, expiry date, etc.)
getregistarlock Get status of domain lock 
setregistarlock Set status of domain lock 
getcontact Get domain contact details
savecontact Modify domain contact details
getnameserver Get nameservers
updatenameserver Modify nameservers
geteppcode Get EPP code
idprotect Switch ID protection on/off
donotrenewSwitch automatic domain renewal on/off

 

RegisterDomain

You can register a domain with this command

Parameter

Possible values / is required?

Description

api_action

registerdomain

Register domain

firstname

required

Firstname of domain owner

lastname

required

Lastname of domain owner

address1

required

Address of domain owner (street, number)

address2

 

Second part of address

city

required

City of owner

state

required

County/State (of owner)

postcode

required

Postcode (of owner)

country

required

Country of owner (2 char ISO code, eg: HU

email

required

Email address of owner

phonenumber

required

Phone number of owner, format eg: +36.12345678

additionalfields

array of fieldnames and values
additionalfields[iszthuident]
additionalfields[lang_eu]

Additional parameters in an array
.hu TLD: iszthuident = unique ID
.eu TLD: eu_lang = language of owner

ns1

required

Primary nameserver

ns2

required

Secondary nameserver

ns3

 

Tertiary nameserver

ns4

 

Quaternary nameserver

ns5

 

Fifth nameserver

regperiod

1+ (integer)

Registration period (years)

 

Response JSON
result=success|error
totalfee= The gross amount of order
If error occurred, error is returned.

Example:

curl -i -X POST \
-H "Content-Type:multipart/form-data" \
-F "sld=testdomain" \
-F "tld=hu" \
-F "Username=reseller@account.com" \
-F "Password=XXXXXX" \
-F "SecretKey=mhd-95fe67e925b3a708224982d9e5080cef" \
-F "valid_domain=www.resellerpage.hu" \
-F "valid_ip=12.34.56.78" \
-F "api_action=registerdomain" \
-F "firstname=Firstname" \
-F "lastname=Lastname" \
-F "address1=Victor Hugo u. 18-22." \
-F "city=Budapest" \
-F "state=Budapest" \
-F "postcode=1132" \
-F "country=HU" \
-F "email=customer@emailaddress.hu" \
-F "phonenumber=+36.11234567" \
-F "additionalfields[iszthuident]=AB12345678" \
-F "ns1=ns1.nameserver.hu" \
-F "ns2=ns2.nameserver.hu" \
-F "regperiod=2" \
'https://online.mhosting.hu/reseller/controller.php'

 

 

TransferDomain

A domain transfer can be requested with this command.

Parameter

Possible values / is required?

Description

api_action

transferdomain

Domain transfer

transfersecret

 

EPP code (if available)

firstname

required

Firstname of owner

lastname

required

Lastname of owner

address1

required

Address of owner (street, number)

address2

 

Second part of address

city

required

City of owner

state

required

County/State (owner)

postcode

required

Postcode (owner)

country

required

Country of owner (2 char ISO code, eg: HU

email

required

Email address of owner

phonenumber

required

Phone number of owner, format eg: +36.12345678

additionalfields

array of fieldnames and values
additionalfields[iszthuident]
additionalfields[lang_eu]

Additional parameters in an array
.hu TLD: iszthuident = unique ID
.eu TLD: eu_lang = language of owner

ns1

required

Primary nameserver

ns2

required

Secondary nameserver

ns3

 

Tertiary nameserver

ns4

 

Quaternary nameserver

ns5

 

Fifth nameserver

regperiod

1+ (integer)

Registration period (years)

idprotection

‘On’ or empty

ID protection

 

Response JSON

result=success|error
totalfee=> Gross amount of order

If error occurred, error is returned.

 

Example:

curl -i -X POST \
-H "Content-Type:multipart/form-data" \
-F "sld=tesztdomain" \
-F "tld=hu" \
-F "Username=reseller@account.com" \
-F "Password=XXXXXX" \
-F "SecretKey=mhd-95fe67e925b3a708224982d9e5080cef" \
-F "valid_domain=www.resellerpage.com" \
-F "valid_ip=12.34.56.78" \
-F "api_action=transferdomain" \
-F "firstname=Firstname" \
-F "lastname=Lastname" \
-F "address1=Victor Hugo u. 18-22." \
-F "city=Budapest" \
-F "state=Budapest" \
-F "postcode=1132" \
-F "country=HU" \
-F "email=customer@emailaddress.hu" \
-F "phonenumber=+36.11234567" \
-F "additionalfields[eu_lang]=HU" \
-F "ns1=ns1.nameserver.hu" \
-F "ns2=ns2.nameserver.hu" \
-F "regperiod=1" \
'https://online.mhosting.hu/reseller/controller.php'

RenewDomain

Command for renewal of a domain

Parameter

Possible values / is required?

Description

api_action

renewdomain

Domain renewal

regperiod

1+ (integer)

Period of renewal (zears)

idprotection

'On' or empty

ID protection

 

Response JSON
result=success|error
totalfee=> Gross amount of order

If error occurred, error is returned.

 

DailyUpdate

Get the parameters of a domain.

Parameter

Possible values / is required?

Description

api_action

dailyupdate

 

status request

 

Response JSON
result=success|error
domain: a the domain name
donotrenew: status of automatic renewal (1: disabled, 0: enabled)
status: domain status
domainid: a domain id number
regdate: date of registration
expdate: date of expiry
nextduedate: next due date
dnsmanagement: not in use
emailforwarding: not in use
idprotection: status of ID protection (0/1)
regperiod: current renewal period
renewstatusUpdated: not in use
idprotectionUpdated: not in use
regperiodUpdated: not in use

If error occurred, error is returned.

 

GetNameservers

Ezzel a paranccsal lekérdezhetők a domain névszerverei.

Parameter

Possible values / is required?

Description

api_action

getnameserver

Get Nameserver list

 

Response JSON
result=success|error
ns1,ns2,ns3,ns4,ns5,expdate,regdate,status,

If error occurred, error is returned.

 

SaveNameservers

Update nameservers

Parameter

Possible values

Description

api_action

updatenameserver

Update nameserver

ns1

required

Primary namerver

ns2

required

Secondary Nameserver

ns3

not required

Tertiary Nameserver

ns4

not required

Quaternary Nameserver

Ns5

not required

Fifth Nameserver

 

Response JSON
result=success|error
If error occurred, error is returned.

 

GetRegistarLock

This command queries the status of registrar lock.

Parameter

Possible values / is required?

Description

api_action

getregistarlock

Query registrar lock

 

Response JSON
result=success|error
lock=1 if lock is active nad 0 if the lock is inactive

If error occurred, error is returned.

 

SaveRegistrarLock

Command to modifz the registrar lock.

Parameter

Possible values / is required?

Description

api_action

setregistarlock

Modifz registrar lock status

lockstatus

'locked' or 'unlocked'

Modify lock

 

Response JSON
result=success|error
If error occurred, error is returned.

 

GetEPPCode

Query EPP code.

Parameter

Possible values / is required?

Description

api_action

geteppcode

 

Query EPP code

 

Response JSON
result=success|error
eppcode (base64_encoded)
sendemail (if the EPP code is sent out instead of value in response)

If error occurred, error is returned.

 

IDProtect

The status of ID protection can be switched on/off.

Parameter

Possible values / is required?

Description

api_action

idprotect

Toggle ID protection

protectenable

0,1

0: disable/off
1: enable/on

 

Response JSON
result=success|error

If error occurred, error is returned.

 

DoNotRenew

Switch automatic domain renewal on/off.

Parameter

Possible values / is required?

Description

api_action

donotrenew

modify automatic renewal

renewstatus

0,1

0: enable auto renewal/on
1: disable automatic renewal/off

 

Response JSON
result=success|error

If error occurred, error is returned.

Hasznosnak találta ezt a választ? 0 A felhasználók hasznosnak találták ezt (0 Szavazat)