| GET | /api/licensee/contacts |
|---|
import Foundation
import ServiceStack
/**
* Returns a list of contacts a licensee is linked to. Contacts are returned in batches.
*/
// @Api(Description="Returns a list of contacts a licensee is linked to. Contacts are returned in batches.")
public class GetLicenseeContactList : Codable
{
/**
* Number of contacts to retrieve per call.
*/
// @ApiMember(DataType="int", Description="Number of contacts to retrieve per call.", IsRequired=true, Name="BatchSize", ParameterType="body")
public var batchSize:Int
/**
* Call number (1=1st, 2=2nd) this should progress upwards until all contacts have been retrieved.
*/
// @ApiMember(DataType="int", Description="Call number (1=1st, 2=2nd) this should progress upwards until all contacts have been retrieved.", IsRequired=true, Name="BatchNumber", ParameterType="body")
public var batchNumber:Int
/**
* An optional role that a contact must have in order to be returned.
*/
// @ApiMember(DataType="Guid", Description="An optional role that a contact must have in order to be returned. ", Name="ContactRole", ParameterType="body")
public var contactRole:String
required public init(){}
}
// @ApiResponse(Description="List of Contacts")
public class GetLicenseeContactListResponse : Codable
{
/**
* List of contacts.
*/
// @ApiMember(DataType="List<ConnectedContactModel>", Description="List of contacts.", Name="Contacts", ParameterType="body")
public var contacts:[ConnectedContactModel]
/**
* Details of the api response. Success/Fail.
*/
// @ApiMember(DataType="ResponseStatus", Description="Details of the api response. Success/Fail.", Name="ResponseStatus", ParameterType="body")
public var responseStatus:ResponseStatus
required public init(){}
}
public class ConnectedContactModel : Codable
{
/**
* Guid of the contact object within Eros.
*/
// @ApiMember(DataType="Guid", Description="Guid of the contact object within Eros.", Name="ContactId", ParameterType="body")
public var contactId:String
/**
* The salutation(preferred name) for the contact. Applies to a person contact type.
*/
// @ApiMember(DataType="string", Description="The salutation(preferred name) for the contact. Applies to a person contact type.", Name="Salutation", ParameterType="body")
public var salutation:String
/**
* The title for the contact. Applies to a person contact type.
*/
// @ApiMember(DataType="string", Description="The title for the contact. Applies to a person contact type.", Name="Title", ParameterType="body")
public var title:String
/**
* The first given name for the contact. Applies to a person contact type.
*/
// @ApiMember(DataType="string", Description="The first given name for the contact. Applies to a person contact type.", Name="FirstName", ParameterType="body")
public var firstName:String
/**
* Any middle names for the contact. Applies to a person contact type.
*/
// @ApiMember(DataType="string", Description="Any middle names for the contact. Applies to a person contact type.", Name="MiddleName", ParameterType="body")
public var middleName:String
/**
* The surname for the contact. Applies to a person contact type.
*/
// @ApiMember(DataType="string", Description="The surname for the contact. Applies to a person contact type.", Name="Surname", ParameterType="body")
public var surname:String
/**
* The full name for the contact.
*/
// @ApiMember(DataType="string", Description="The full name for the contact.", Name="FullName", ParameterType="body")
public var fullName:String
/**
* A legal name for the contact. Applies to an organisation contact type.
*/
// @ApiMember(DataType="string", Description="A legal name for the contact. Applies to an organisation contact type.", Name="LegalName", ParameterType="body")
public var legalName:String
/**
* A trading name for the contact. Applies to an organisation contact type.
*/
// @ApiMember(DataType="string", Description="A trading name for the contact. Applies to an organisation contact type.", Name="TradingName", ParameterType="body")
public var tradingName:String
/**
* The birth date for the contact. Applies to a person contact type.
*/
// @ApiMember(DataType="DateTime?", Description="The birth date for the contact. Applies to a person contact type.", Name="BirthDate", ParameterType="body")
public var birthDate:Date?
/**
* Guid of the marital status within Eros.
*/
// @ApiMember(DataType="Guid?", Description="Guid of the marital status within Eros.", Name="MaritalStatusId", ParameterType="body")
public var maritalStatusId:String?
/**
* The contacts marital status if set.
*/
// @ApiMember(DataType="string", Description="The contacts marital status if set.", Name="MaritalStatusName", ParameterType="body")
public var maritalStatusName:String
/**
* Guid of the gender within Eros.
*/
// @ApiMember(DataType="Guid?", Description="Guid of the gender within Eros.", Name="GenderId", ParameterType="body")
public var genderId:String?
/**
* The contacts gender if set.
*/
// @ApiMember(DataType="string", Description="The contacts gender if set.", Name="GenderName", ParameterType="body")
public var genderName:String
/**
* Preferred language of the contact.
*/
// @ApiMember(DataType="string", Description="Preferred language of the contact.", Name="Language", ParameterType="body")
public var language:String
/**
* If true, the contact requires an interpreter.
*/
// @ApiMember(DataType="bool", Description="If true, the contact requires an interpreter.", Name="InterpreterRequired", ParameterType="body")
public var interpreterRequired:Bool
/**
* Contact Type name of the contact.
*/
// @ApiMember(DataType="string", Description="Contact Type name of the contact.", Name="ContactTypeName", ParameterType="body")
public var contactTypeName:String
/**
* Guid of the Contact Type List Item object within Eros.
*/
// @ApiMember(DataType="Guid", Description="Guid of the Contact Type List Item object within Eros.", Name="ContactTypeId", ParameterType="body")
public var contactTypeId:String
/**
* Description of the contact for their external profile.
*/
// @ApiMember(DataType="string", Description="Description of the contact for their external profile.", Name="Description", ParameterType="body")
public var Description:String
/**
* Contact 'Profession/Trade/Industry' details for their external profile.
*/
// @ApiMember(DataType="string", Description="Contact 'Profession/Trade/Industry' details for their external profile.", Name="EmploymentIndustry", ParameterType="body")
public var employmentIndustry:String
/**
* Contact 'Working/Subcontracting for' details for their external profile.
*/
// @ApiMember(DataType="string", Description="Contact 'Working/Subcontracting for' details for their external profile.", Name="EmploymentRole", ParameterType="body")
public var employmentRole:String
/**
* Contact 'Work Area/Suburbs' detail for their external profile.
*/
// @ApiMember(DataType="string", Description="Contact 'Work Area/Suburbs' detail for their external profile.", Name="EmploymentGeographicArea", ParameterType="body")
public var employmentGeographicArea:String
/**
* The A.B.N for the contact.
*/
// @ApiMember(DataType="string", Description="The A.B.N for the contact.", Name="Abn", ParameterType="body")
public var abn:String
/**
* The A.C.N for the contact.
*/
// @ApiMember(DataType="string", Description="The A.C.N for the contact.", Name="Acn", ParameterType="body")
public var acn:String
/**
* The A.R.B.N for the contact.
*/
// @ApiMember(DataType="string", Description="The A.R.B.N for the contact.", Name="Arbn", ParameterType="body")
public var arbn:String
/**
* Timezone name that applies to the contact.
*/
// @ApiMember(DataType="string", Description="Timezone name that applies to the contact.", Name="TimezoneName", ParameterType="body")
public var timezoneName:String
/**
* A list of the contact details for the contact.
*/
// @ApiMember(DataType="List<ConnectedContactDetailModel>", Description="A list of the contact details for the contact.", Name="ContactDetails", ParameterType="body")
public var contactDetails:[ConnectedContactDetailModel]
/**
* A list of the contact addresses for the contact
*/
// @ApiMember(DataType="List<ConnectedContactAddressModel>", Description="A list of the contact addresses for the contact", Name="ContactAddresses", ParameterType="body")
public var contactAddresses:[ConnectedContactAddressModel]
/**
* True if this contact has at least 1 active connection to the licensee. Without an active connection only public profile information for the contact is returned.
*/
// @ApiMember(DataType="bool", Description="True if this contact has at least 1 active connection to the licensee. Without an active connection only public profile information for the contact is returned.", Name="IsContactConnected", ParameterType="body")
public var isContactConnected:Bool
/**
* A list of connections this contact has with the licensee. May be active or a pending request to connect.
*/
// @ApiMember(DataType="List<ConnectedContactConnectionsModel>", Description="A list of connections this contact has with the licensee. May be active or a pending request to connect.", Name="Connections", ParameterType="body")
public var connections:[ConnectedContactConnectionsModel]
/**
* A list of projects this contact is linked to as a customer.
*/
// @ApiMember(DataType="List<ContactLinkedCustomerProjectsModel>", Description="A list of projects this contact is linked to as a customer.", Name="Projects", ParameterType="body")
public var projects:[ContactLinkedCustomerProjectsModel]
/**
* A list of integration subscriptions used to link this contact to external records in other licensee owned systems.
*/
// @ApiMember(DataType="List<ConnectedContactSubscriptionsModel>", Description="A list of integration subscriptions used to link this contact to external records in other licensee owned systems.", Name="Subscriptions", ParameterType="body")
public var subscriptions:[ConnectedContactSubscriptionsModel]
required public init(){}
}
public class ConnectedContactDetailModel : Codable
{
/**
* The type of contact detail this is (email/mobile/fax/website etc)
*/
// @ApiMember(DataType="string", Description="The type of contact detail this is (email/mobile/fax/website etc)", Name="Type", ParameterType="body")
public var type:String
/**
* The contact detail. e.g (phone number or email address)
*/
// @ApiMember(DataType="string", Description="The contact detail. e.g (phone number or email address)", Name="ContactDetails", ParameterType="body")
public var contactDetails:String
required public init(){}
}
public class ConnectedContactAddressModel : Codable
{
/**
* A full address string of the address.
*/
// @ApiMember(DataType="string", Description="A full address string of the address.", Name="FullAddress", ParameterType="body")
public var fullAddress:String
/**
* If true, this is the contacts primary address.
*/
// @ApiMember(DataType="bool", Description="If true, this is the contacts primary address.", Name="IsPrimary", ParameterType="body")
public var isPrimary:Bool
/**
* If true, this is the contacts postal address.
*/
// @ApiMember(DataType="bool", Description="If true, this is the contacts postal address.", Name="IsPostal", ParameterType="body")
public var isPostal:Bool
/**
* If true, this is the contacts registered address.
*/
// @ApiMember(DataType="bool", Description="If true, this is the contacts registered address.", Name="IsRegistered", ParameterType="body")
public var isRegistered:Bool
required public init(){}
}
public class ConnectedContactConnectionsModel : Codable
{
/**
* Guid of the role within Eros
*/
// @ApiMember(DataType="Guid", Description="Guid of the role within Eros", Name="RoleId", ParameterType="body")
public var roleId:String
/**
* Name of the role this contact is connected to the licensee with.
*/
// @ApiMember(DataType="string", Description="Name of the role this contact is connected to the licensee with.", Name="Role", ParameterType="body")
public var role:String
/**
* Guid of the role connections status within Eros.
*/
// @ApiMember(DataType="Guid", Description="Guid of the role connections status within Eros.", Name="StatusId", ParameterType="body")
public var statusId:String
/**
* Connection status of the role. It maybe active or pending.
*/
// @ApiMember(DataType="string", Description="Connection status of the role. It maybe active or pending.", Name="Status", ParameterType="body")
public var status:String
required public init(){}
}
public class ContactLinkedCustomerProjectsModel : Codable
{
/**
* Guid of the project within Eros.
*/
// @ApiMember(DataType="Guid", Description="Guid of the project within Eros.", Name="ProjectId", ParameterType="body")
public var projectId:String
/**
* Name of the project.
*/
// @ApiMember(DataType="string", Description="Name of the project.", Name="Name", ParameterType="body")
public var name:String
required public init(){}
}
public class ConnectedContactSubscriptionsModel : Codable
{
/**
* Guid of the datasource within Eros.
*/
// @ApiMember(DataType="Guid", Description="Guid of the datasource within Eros.", Name="DatasourceId", ParameterType="body")
public var datasourceId:String
/**
* Name of the datasource that is the external system with a record of this contact.
*/
// @ApiMember(DataType="string", Description="Name of the datasource that is the external system with a record of this contact.", Name="Datasource", ParameterType="body")
public var datasource:String
/**
* Foreign Key lookup of this contact in the external system the datasource represents.
*/
// @ApiMember(DataType="string", Description="Foreign Key lookup of this contact in the external system the datasource represents.", Name="AlternateKey", ParameterType="body")
public var alternateKey:String
required public init(){}
}
Swift GetLicenseeContactList DTOs
To override the Content-type in your clients, use the HTTP Accept Header, append the .json suffix or ?format=json
To embed the response in a jsonp callback, append ?callback=myCallback
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
GET /api/licensee/contacts HTTP/1.1 Host: production-eros-platform-apisubscription.azurewebsites.net Accept: application/json
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length
{"Contacts":[{"Salutation":"String","Title":"String","FirstName":"String","MiddleName":"String","Surname":"String","FullName":"String","LegalName":"String","TradingName":"String","BirthDate":"0001-01-01T00:00:00.0000000","MaritalStatusId":"00000000-0000-0000-0000-000000000000","MaritalStatusName":"String","GenderId":"00000000-0000-0000-0000-000000000000","GenderName":"String","Language":"String","InterpreterRequired":false,"ContactTypeName":"String","Description":"String","EmploymentIndustry":"String","EmploymentRole":"String","EmploymentGeographicArea":"String","Abn":"String","Acn":"String","Arbn":"String","TimezoneName":"String","ContactDetails":[{"Type":"String","ContactDetails":"String"}],"ContactAddresses":[{"FullAddress":"String","IsPrimary":false,"IsPostal":false,"IsRegistered":false}],"IsContactConnected":false,"Connections":[{"Role":"String","Status":"String"}],"Projects":[{"Name":"String"}],"Subscriptions":[{"Datasource":"String","AlternateKey":"String"}]}],"ResponseStatus":{"ErrorCode":"String","Message":"String","StackTrace":"String","Errors":[{"ErrorCode":"String","FieldName":"String","Message":"String","Meta":{"String":"String"}}],"Meta":{"String":"String"}}}