| GET | /2.0/address/{Postcode} | ||
|---|---|---|---|
| GET | /2.0/address/{Postcode}/{HouseNo} |
import java.math.*
import java.util.*
import java.io.InputStream
import net.servicestack.client.*
open class AddressRequest : IHasVersion
{
open var Version:Int? = null
/**
* Using a Postcode to return addresses.
*/
@ApiMember(DataType="string", Description="Using a Postcode to return addresses.", IsRequired=true, Name="Postcode", ParameterType="path")
open var Postcode:String? = null
/**
* Optional input value to limit the return data to a specific address.
*/
@ApiMember(DataType="string", Description="Optional input value to limit the return data to a specific address.", Name="House Name or Number", ParameterType="path")
open var HouseNo:String? = null
}
@DataContract(Name="LookupResult", Namespace="http://schemas.datacontract.org/2004/07/PostcodeLookupService")
open class LookupResult
{
@DataMember
open var Addresses:ArrayList<Address>? = null
@DataMember
open var errormsg:String? = null
}
@DataContract(Name="Address", Namespace="http://schemas.datacontract.org/2004/07/PostcodeLookupService")
open class Address
{
@DataMember
open var County:String? = null
@DataMember
open var Id:Int? = null
@DataMember
open var Locality:String? = null
@DataMember
open var Organisation:String? = null
@DataMember
open var Postcode:String? = null
@DataMember
open var Property:String? = null
@DataMember
open var RAPPPremiseId:Int? = null
@DataMember
open var Street:String? = null
@DataMember
open var Town:String? = null
@DataMember
open var FullAddress:String? = null
}
To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
GET /2.0/address/{Postcode} HTTP/1.1
Host: webservices.mbukdatabase.co.uk
Accept: text/jsv
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length
{
Addresses:
[
{
County: String,
Id: 0,
Locality: String,
Organisation: String,
Postcode: String,
Property: String,
RAPPPremiseId: 0,
Street: String,
Town: String,
FullAddress: "String, String, String, String, String, String"
}
],
errormsg: String
}