🎯 Purpose for OutSystems Tutorial
This API is essential for teaching **SOAP Web Service consumption**, which is entirely different from REST. It shows how to:
- Point OutSystems to the **WSDL URL** (currency-converter.wsdl) to automatically generate service methods.
- Work with SOAP's complex XML-based requests and responses.
- Understand the difference between the **WSDL** (contract) and the **SOAP Endpoint** (the service logic).
🔗 Service Details
WSDL URL (Service Contract)
This is the file you provide to OutSystems to generate the methods:
http://api.ankitg.in/api/currency-converter.wsdl
SOAP Endpoint (Service Implementation)
This is where the actual requests are sent (as defined inside the WSDL):
http://api.ankitg.in/api/currency-converter-service.php
Available Operation:
ConvertCurrency
Request Parameters:
| Parameter Name | Type | Example |
|---|---|---|
| Amount | Decimal | 100.00 |
| FromCurrency | Text | USD |
| ToCurrency | Text | INR |
💬 Expected Response
Success Response Structure:
The service returns two decimal values:
| Parameter Name | Type | Description |
|---|---|---|
| ConvertedAmount | Decimal | The final calculated amount. |
| RateUsed | Decimal | The conversion factor used in the calculation. |
Example XML Response (Response body when converting 10 USD to INR):
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<tns:ConvertCurrencyResponse xmlns:tns="http://api.ankitg.in/soap/currency-converter">
<tns:ConvertedAmount>830.00</tns:ConvertedAmount>
<tns:RateUsed>83.0000</tns:RateUsed>
</tns:ConvertCurrencyResponse>
</soap:Body>
</soap:Envelope>