Pirin Manual - The Partner Module
This module is implemented by the Partner. This module talks to the Names4Ever Request and Response module using XML as a standard data format. The Partner’s Module interacts with Names4Ever Request and Response module through a CGI interface over HTTPS connection.
Requirements
3.1 Functionality
The Partner Module implements the interface between the Partner’s internal system and the Names4Ever Pirin Open Interface Module. This is implemented by the Partner and installed on Partner’s systems. The Partner Module has the following functions:
This function generates requests based on desired functionality. The requests are in XML format, which conform to a specific DTD (Document Type Definition). The DTDs should be used to validate the XML request document before they are sent for processing. The DTDs are published and publicly available at http://www.names4ever.com/PirinLink/request.dtd.
3.1.2. Request Submission
This involves submission of the XML data as a stream. This is achieved by performing a “POST” on a well-known URL – https://www.names4ever.com/PirinLink/Pirin.exe The URL is for an SSL server, which listens for requests on a secure port. Hence, the submission should be made using SSL to port 443 (which is the default).
3.1.3. Response Handling
The Request submission generates a Response, which is also in XML format. The response handling, entails parsing the XML response (Using a standard XML parser) and handling the response. The response format conforms to the response DTD that is published at http://www.names4ever.com/PirinLink/response.dtd.
As can be inferred from the above, Pirin Open Interface does not dictate the implementation (e.g. the language – C, Java, Perl, the system - Unix, NT), as long as there is compliance to the defined XML format for data interchange.
A test bed is provided for Partners who are interested in testing their integrations using the Pirin. This testbed provides the exact same interface, with the exception that the orders are not actually processed. All resellers are expected to test their integrations before they are granted access to the production systems. The Testbed URL is https://www.names4ever.com/PirinLink/PirinTest.exe. Please note that all the SSL URLs mentioned in this document have a non-SSL version available also.
An API for both C++ and Perl languages is provided. You can download the whole package from PirinAPI.zip. Carefully read the API documentation first. You can download documentation in PDF format from PirinAPI.pdf or you can read it on-line from PirinAPI.htm. A package with only Perl modules and samples is provided for Perl developers - pirinmod.tar.gz.
Print this page
Email this page