To activate Event Notifications, please visit the Reseller Control Panel. Navigate to Account Settings page in the top right hand corner and select the Event Notifications tab to configure which events you would like to receive.
Which brings up the Account Settings page with the Event Notification tab :
If you enable the email option, you can configure where the email is sent and details included by navigating to New Messaging (top right hand corner of Control Panel) -> Event notification message template.
Email Notifications
Once emailed and triggered by an Event, the OpenSRS system sends the technical contact on the account an email for every Event. The body of the email that is sent is a JSON data structure, intended for scripts or a database to parse. Here are example Event Notification emails of a domain being transferred into the system, and having it's nameservers updated :
Subject : Event notification: DOMAIN: CREATED: 75675eb3d5010da7c8dbd1c638f7ca55
{"object_data":{"domain_name":
Subject : Event notification: TRANSFER: STATUS_CHANGE: 70ee0bd48660c737cc1b08501e214236
{"object_data":{"domain_name":
Subject : Event notification: DOMAIN: NAMESERVER_UPDATE: dc3295cdca977bbd227fda140ca7f4dc
{"object_data":{"domain_name":
Here is a breakdown of the various items in the Event Notification email.
API Calls
Usage
When API polling for Event Notifications is enabled, you can send queries for events that have occurred. The command syntax is below, followed by API examples.
Command Syntax
NOTE:
- All dates are full ISO8601 format (UTC)
COMMON DATA
event - (description for each below)
event_id - unique identifier of this event
event_date
COMMON DATA FOR OBJECT (within object_data): DOMAIN
domain_id
domain_name
COMMON DATA FOR OBJECT (within object_data): ORDER
order_id
domain_name
COMMON DATA FOR OBJECT (within object_data): TRANSFER
transfer_id
order_id
domain_name
OBJECT: DOMAIN
EVENT: CREATED
DESCRIPTION: The domain was added to the system due to any number of actions including, registration, transfer completion, redemption, back-end import, etc. Basically if a domain is added to our database for ANY reason, this event will be dispatched.
expiration_date
OBJECT: DOMAIN
EVENT: EXPIRED
DESCRIPTION: The domain has reached DAY 0 without being renewed.
expiration_date
OBJECT: DOMAIN
EVENT: NAMESERVER_UPDATE
DESCRIPTION: The nameservers set for this domain have changed.
nameserver_list - Array of nameservers as set at the moment of this event
OBJECT: DOMAIN
EVENT: REGISTERED
DESCRIPTION: A domain registration has completed.
expiration_date
period - Number of years registered for
OBJECT: DOMAIN
EVENT: REGISTRANT_VERIFICATION_STATUS_CHANGE
DESCRIPTION: Notifies of a change to the registrant verification status for this domain. This gives visibility into the state of a registrant's verification.
verification_status - unverified pending verifying marking_as_verified verified suspended admin_reviewing bounced not_applicable
OBJECT: DOMAIN
EVENT: RENEWED
DESCRIPTION: This event will be fired whenever a renewal is processed for a domain, whther it be through auto-renewal, or a manually created renewal order.
expiration_date
period - Number of years renewed for
OBJECT: DOMAIN
EVENT: ZONE_CHECK_STATUS_CHANGE
DESCRIPTION: For .de and .fr, will notify when the DNS/ZONE check has passed, or failed at the registry, as the domain is in jeopardy of being disabled by the registry if it remains invalid.
zone_check_status - valid invalid
OBJECT: DOMAIN
EVENT: DELETED
DESCRIPTION:
reason - expired transfered auction historical by-request delete-domain-api
deletion_date
redemption_grace_period_end_date
OBJECT: ORDER
EVENT: CLAIM_STATUS_CHANGE
DESCRIPTION:
claim_status - initiated declined cancelled accepted
OBJECT: ORDER
EVENT: STATUS_CHANGE
DESCRIPTION:
order_status - cancelled completed declined pending pending_fax processed waiting
order_reg_type - landrush new premium renewal sunrise transfer whois_privacy
OBJECT: TRANSFER
EVENT: STATUS_CHANGE
DESCRIPTION:
transfer_status - cancelled completed pending_admin pending_owner pending_registry
Example API Calls
The Event Notifications use the standard OpenSRS API, with new commands available to poll for notifications.
To begin, poll the OpenSRS server for Event Notification results. We recommend you query one event at a time, however you can set the item key="limit” to a maximum of 100 events per call.
Request :
0.9 XCP EVENT POLL 1
Response:
0.9 XCP EVENT 200 1 Command successful 2014-05-29 11:14:02 23004 101 REPLY abc-fictional.de 801743 invalid DOMAIN 6887c7d3838dcaec7517c531df527bb7 ZONE_CHECK_STATUS_CHANGE 2014-05-27T19:29:25Z 1
Once you have received the poll results, you must ACK the event(s) to remove them from the Notification queue or they will keep being sent to you when you query events.
Request :
0.9 XCP EVENT ACK 6887c7d3838dcaec7517c531df527bb7
Response:
0.9 XCP EVENT 200 1 Command successful 2014-05-29 11:17:03 22962 101 REPLY 0
Attached below are example responses for every type of Event Notification.
Was this article helpful? If not please submit a request here