Request and Response Format - SOAP
The client and the server exchange SOAP messages via HTTP::POST. The header of the request message contains the userid and password of the registrar who sent the request. This is the same userid and password used to login to registrar tools.
Below is a sample registration transaction.
<?xml version="1.0"?> <SOAP:Envelope xmlns:SOAP="http://schemas.xmlsoap.org/soap/envelope/"
SOAP:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP:Header>
<T:Tran xmlns:T="http://dotph.com">
<T:ID></T:ID>
<T:UserID>testpartner</T:UserID>
<T:Password>testpartner</T:Password>
</T:Tran>
</SOAP:Header>
<SOAP:Body>
<Job>
<details>
<![CDATA[
<Domain name="mydomain.com.ph">
<PaymentInfo>
<PayType>CASH</PayType>
<CardType></CardType>
<CardNo></CardNo>
<CardExpire></CardExpire>
<NameOnCard></NameOnCard>
</PaymentInfo>
<JD type="RegisterDomain" duration="2" ServiceType="RESERVE">
?
</JD>
</Domain>
]]>
</details>
</Job>
</SOAP:Body>
</SOAP:Envelope>
Server response varies per transaction. The server either returns a fault message, an invoice, or the information requested (i.e., availability of domains ? CheckDomain)
Fault
a component of a SOAP message that contains error information
<?xml version="1.0"?>
<SOAP:Envelope
xmlns:SOAP="http://schemas.xmlsoap.org/soap/envelope/" SOAP:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP:Header>
<T:Tran xmlns:T="http://dotph.com">
<T:ID></T:ID>
</T:Tran>
</SOAP:Header>
<SOAP:Body>
<SOAP:Fault>
<faultcode>4</faultcode>
<faultstring>Domain name not available</faultstring>
<faultactor>serverURI</faultactor>
<detail>RegisterDomain-The online search showed that the domain name specified was still available at the time. Unfortunately, the domain has since been paid and registered by another user.</detail>
</SOAP:Fault>
</SOAP:Body>
</SOAP:Envelope>
Invoice
An invoice is returned by the following operations:
Register Domain
Modify Domain Information
Modify Webforwarding
Renew Domain
Edit Name Servers
It contains a list of operations performed (JD), the total charges (Total attribute of Invoice), and the transaction tracking number (id attribute of Invoice).
<?xml version="1.0"?>
<SOAP:Envelope
xmlns:SOAP="http://schemas.xmlsoap.org/soap/envelope/" SOAP:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP:Header>
<T:Tran xmlns:T="http://dotph.com">
<T:ID></T:ID>
</T:Tran>
</SOAP:Header>
<SOAP:Body>
<JobResponse>
<return><![CDATA[
<Invoice Total="50" id="38038" currency="usd">
<Domain name="mydomain.com.ph">
<JD type="RegisterDomain" duration="2" cost="50.00" currency="usd"></JD>
<Charges total="50" currency="usd"/></Domain>
</Invoice>
]]>
</return>
</JobResponse>
</SOAP:Body>
</SOAP:Envelope>
August 19, 2003
[ Back ]