Operation management
Contents |
New operations
When an operation is requested, you get a unique tracking number. The latter can then be used to track the progress and status of an operation.
Operations can be requested in several ways:
Using the API
Each call to the API function returns an array containing the operation information
For experienced users seeking to automate tasks
Using API forms into the Web Interface
Each function has a form in the section "Resellers" > "API domain", "API hosting" et "API SSL"
These forms are used to enter the parameters needed by each function. After submitting the form, the API is called and returns an array containing the operation information.
For experienced users seeking to use complex or not automated tasks
Using the Web Interface
In general, the use of the Web Interface to manage services systematically generates an operation
For all users
Using our website
For registrations or transfers, using the website to pass orders offers the advantage of providing a simplified wizard especially in complex steps relative to additional fields.
For all users
Operation follow-up
Operation results are as follows:
PENDING | The operation is being processed |
DONE | The operation has been successfully performed and is finished |
FAILED | The operation has failed and is finished |
CANCELLED | The operation has been cancelled either by Netim, either by the reseller |
Using the API
In order to retrieve the status of any operation, the function queryOpe must be called with the corresponding tracking number as parameter.
In practice, Resellers develop a script that will query the API at regular intervals on the uncommitted transactions in their system For each operation, they obtain the result, update their data and continues their internal processes.
Using notifications
The result is described in the CPS of #notifications.
In practice, Resellers develop a script that will read at regular intervals the email address that receives all notifications. For each email received, they obtain the result, update their data and continues their internal processes.
Using the Web Interface
Resellers can track all operations in the Web Interface, section "Resellers" > "List of operations"
Restart an operation
There is no function for restarting an operation by yourself.
So when an operation has failed, you must request it again (with the needed changes into the parameters) and you will get a new tracking ID.
Sometimes, an operation failed on our side and you got one of the following error codes:
E12-M1201 Operation can't be performed - An internal error occurred E12-M1210 Operation can't be performed - An error occured during the request at the registry
If this situation occurs, as we monitor all requested operations, we will intervene onto the problem that causes the error and restart the operation.
Cancel an operation
It is possible to cancel a transaction with the CancelOpe function provided that it has not yet been initiated with the registry
Inquiring opened operations
We provide a list of possible operations onto domain names and contact objects. However, according to the extension of the domain name, some of them can be impossible. For example, if the autorization code doesn't exist for belgium, the function domainAuthID onto a .BE domain name will be closed.
With the queryOpeList function , the reseller can query the system onto an extension and an operation to see if the latter is opened. For example, opened operations for each extension is displayed in the section Category:Tld
Notifications
Structure
Each notification is sent by email with the MIME format and consists of text plain part (Content-Type: text/plain; charset=UTF-8) and an html part (Content-Type: text/html; charset=UTF-8)
The text part contains a CPS section (Computer Parsed Section) in order to facilitate the parsing of the body and retreive easily the needed information. Below an example of a CPS section:
with status DONE
----BEGIN-OF-CPS---- TYPE: domainCreate REQUEST: 318110 OBJECT: xxxxxxxxxxxx.com ACTION: DONE ----END-OF-CPS----
with status FAILED
----BEGIN-OF-CPS---- TYPE: domainCreate REQUEST: 318110 OBJECT: xxxxxxxxxxxx.com ACTION: FAILED ERRNO: EXX-XXXXX ERRSTR: ????????????? ----END-OF-CPS----
The fields for CPS are defined as follows:
TYPE | The operation | |
REQUEST | The tracking number | |
OBJECT | The object for which the operation applies | |
ACTION | The result | |
ERRNO | The error number | optional |
ERRSTR | The error message | optional |
VALUE | The value corresponding to the operation | optional |
Settings
The resellet can enable/disable these notifications or define the recipient email address. See Reseller settings
Expiration reminder notifications
The notifications below are not related to an operation but to the life cycle of a domain name.
The reseller can enable / disable the receipt of these notifications. Reseller settings
Domain name expiration
Dear customer, Your domain name xxxxxxx.com is due to expire today ! Creation date : 2008-12-01 Expiry date : 2009-12-01 Deadline for renewal : 2009-12-08 before 09:00 PM (UTC+1) Your domain is now in state of "Pre-closing" status during which we maintain, free of charge, your domain in order to allow you enough time to renew it. However, after this period, your domain shall be deleted. In order to keep your domain, you will have to renew it before 2009-12-08 09:00 PM (UTC+1). For any further information, feel free to contact our support. Netim ----BEGIN-OF-CPS---- TYPE: DOMAIN_NOTIFY OBJECT: xxxxxxx.com ACTION: EXPIRED VALUE: 2009-12-08 ----END-OF-CPS----
Domain name deletion followed by a quarantine
Dear customer, Please note that this is our last letter about your domain name xxxxxxx.ch, which has still not been renewed and will be removed. Creation date : 2008-12-01 Expiry date : 2009-12-01 Deadline for renewal : 2009-12-08 before 09:00 PM (UTC+1) Netim has now requested the deletion of domain for non-renewal and will be removed soon. Restoration procedure: The domain will be in a redemption status until 2009-12-22 and before becoming available again for registration. During this stage, you are the only one able to restore the domain and keep the ownership. For any further information, feel free to contact our support. Netim ----BEGIN-OF-CPS---- TYPE: DOMAIN_NOTIFY OBJECT: xxxxxxx.ch ACTION: DELETION_WITH_REDEMPTION VALUE: 2009-12-22 ----END-OF-CPS----
Domain name deletion without quarantine
Dear customer, Please note that this is our last letter about your domain name xxxxxxx.cz, which has not yet been renewed and will be removed. Creation date : 2008-12-01 Expiry date : 2009-12-01 Deadline for renewal : 2009-12-01 before 09:00 PM (UTC+1) Netim has now requested the domain deletion for non-renewal and will be removed soon. For any further information, feel free to contact our support. Netim ----BEGIN-OF-CPS---- TYPE: DOMAIN_NOTIFY OBJECT: xxxxxxx.cz ACTION: DELETION ----END-OF-CPS----