Technical FAQ.


What are the possible return codes of the e-mail based registration system?

The return codes are:
0 -> 'Content check ok'
1 -> 'Signature error'
10 -> 'Internal server error'
3x -> 'Syntax error'
100 -> 'Missing consistancy conditions for %s'
101 -> 'Domain %s invalid status : %s'
104 -> 'Maximum billingcontacts reached'
105 -> 'Invalid contact handle %s'
106 -> 'Contact still linked to %d domain(s)'
107 -> 'No valid tech or onsite contact given'
108 -> 'Invalid IP address : %s'
109 -> 'Invalid number of nameservers'
111 -> 'This agent has not enough money to register a new domain'
112 -> 'The domain %s is not the property of the agent %s'
113 -> 'The domain %s is already deleted'
114 -> 'The domain %s could not be found'
117 -> 'The agent %s is not activated'
118 -> 'The IP address %s is not required for the nameserver %s'
120 -> 'The domain %s is already being transfered'
121 -> 'The domain %s is already yours'
122 -> 'Missing glue for %s'
123 -> 'Invalid nameserver %s'
124 -> 'Domain %s already scheduled for delete',
125 -> 'Licensee contact %s invalid status : %s',
126 -> 'Domain %s not scheduled for delete'
128 -> 'No valid billing contact given'
260 -> 'Nameservergroup already in use'
261 -> 'Invalid nameservergroup'
264 -> 'Nameservergroup still linked to domain(s)'
8000 -> 'No syntactically correct form found.'
8001 -> 'No templatename found.
8002 -> 'Unknown templatename.'
8003 -> 'End of input reached.'
8004 -> 'Syntax error on begin/end tags.'


What are the possible return messages of the e-mail based registration system?

We only guarantee the first five lines of the return message.
these are:
%%! Transcript of transaction : *date*
%%! Server Version : 1.0 (build 20001210)
RETURNCODE : *returncode*
RETURNMESSAGE : *returnmessage*
REFERENCE : *reference*

If the returncode is 0 (succeeded), there are 2 more fields:
STATUS: *status*
DETAIL: *detail*

STATUS can be either CREATED, UPDATED or DELETED.
DETAIL is a complete detail of the changes that were made, the format depends highly on the changes made.


When do I use NS#-IP in the template?

NS#-IP : ip address of the nameserver.
Only required for glue records.
If there is no need for a glue record, this field should be omitted.
What is a glue record? Take a look at "DNS and BIND" by O'Reilly.


Where do I put the authentication block?

The authentication block has to be APPended to the form.
To calculate the signature, you have to PREpend the passphrase to the form, remove all spaces/tabs/newlines from the form and feed this to an MD5 module. The result (=32 characters) has to be pasted in the authentication block.
Also take a look at the Javascript routine.


Where can I find the handle for a contact?

You will always receive the new contacthandle in our returnmessage to your template.
You can also look up contacthandles with the agent query application.
Please be advised that contacts are always linked to exactly one registrar. If another agent would use this handle, he would get an error. Otherwise, there would be trouble: one agent updating information suddenly also updates information from another agent. Because DNS implies that the agent is ultimately responsible for the data, the agent has to have complete control over it.


How is my template processed?

First check: extract something that looks like a form (from ---BEGIN-OF-DNS-BE-FORM---, till ---END-OF-AGENT-AUTHENTICATION---).
2nd : Check on headers and footers
3rd : Signature check
4th : syntax check
5th : Execute template.


What's the difference between LICENSEE, ONSITE and TECHNICAL?

LICENSEE: the person who owns the license of the domainname.
ONSITE: a technical contact with the client.
TECHNICAL: the technical contact of the Agent/Registrar.


Which are the causes and solutions when you don't receive a correct answer on a whois request?

Possible error messages could be:
%Excessive querying, grace period of xxxxxxxx seconds
IP address blocked.
Both error messages show that the WHOIS service is no longer available for the IP address concerned. The causes of this are discussed in more detail below.

The purpose of WHOIS.

The WHOIS service is a tool that is intended to give Internet users the opportunity to carry out certain checks.

- the licensee of a domain name can check whether his data is correct;
- in the event of problems with a domain, the people in charge are known, and can be contacted;
- third parties who believe that they have a claim to a domain name can contact the licensee thanks to this data.

However, we regularly observe that these restrictions are not respected, which results in automatic blocking of the associated IP address. The WHOIS server will not accept any queries from that specific IP address during the period indicated.
The end-user has a static IP address

In that case, the end-user him/herself is the cause of the blocking. We advise removing the cause so that the problem does not recur in future. All that is required is to wait until the end of the blocking period. After that, the system will automatically become available again.
The end-user has a dynamic IP address

Error message: "IP address blocked".

This can be attributed to one of the following reasons:

- the user attempts to run a WHOIS query via our website by entering the URL directly. This is not allowed, since we always require an HTTP referral. (A query via the browser contains a field with the URL of the page from which the question is sent = HTTP referral). Only if it concerns a referred page of DNS can a WHOIS be allowed. In other words, if a correctly formulated query is sent from another application, it will not be accepted.
The aforementioned reason a) can also be caused by other software blocking the referral mechanism. So, for example, it is possible that the firewall is filtering out this information for privacy reasons. The firewall usually has an option to switch off this change.
We also manually block users who systematically misuse the WHOIS system but remain just within the restrictions imposed. For example, continuously requesting (alphabetical) lists every hour, but not making more than 100 WHOIS queries per hour, for days at a time.


Which are the alternative solutions for making a WHOIS query (without using your website)?

In itself, the WHOIS function on our website is no more than a graphic shell for the WHOIS service, which is text-based.
The WHOIS server can be queried at any time.

Via the WHOIS (who is) protocol:
Whois towards our whois.dns.be whith a WHOIS-client. you can find innumerable WHOIS clients on the Internet.
For Windows a lot of freeware-versions can be found on the net.
Example: via http://www.geektools.com/software.php -> Geek Tool Win 32 Whois Client 5.2.
When you give up a name then you receive the standard output WHOIS-information.



Service description    General FAQ   
Technical FAQ    Registration procedure   
WWW pagina's beveiligen met een paswoord (Dutch)    History: The end of an era   

Call or Fax: +3200084530

E-mail: office@hadopimayonnaise.be
hadopimayonnaise • belgium
Brussels • Amsterdam • Bruges © 2015-2017