ReportingAPI

PostLinkReportRequest

The following routes are available for this service:
POST	/v4/report/links

**PostLinkReportRequest** Parameters:
Name	Parameter	Data Type	Required	Description
Reports	body	IEnumerable<ReportRequest>	No

**ReportRequest** Parameters:
Name	Parameter	Data Type	Required
Items	form	IEnumerable<string>	No
GroupBy	form	IEnumerable<GroupBy>	No
Attribute	form	string	No
Type	form	ReportType	No
FromStartUtcInclusive	form	DateTime	No
FromEndUtcInclusive	form	DateTime	No
Retailers	form	IEnumerable<string>	No

**GroupBy** Enum:
Default
Retailer
Date

**ReportType** Enum:
ShortUrl
Group
User

**PostLinkReportResponse** Parameters:
Name	Parameter	Data Type	Required	Description
Reports	form	IEnumerable<Report>	No
ResponseStatus	form	ResponseStatus	No

**Report** Parameters:
Name	Parameter	Data Type	Required
Data	form	List<ReportData>	No
ExecutionTimeMs	form	long	No
TotalItems	form	long	No
Errors	form	List<Error>	No
Request	form	ReportRequest	No
TotalClicks	form	long	No

**ReportData** Parameters:
Name	Parameter	Data Type	Required
Id	form	string	No
Item	form	Item	No
TotalClicks	form	ulong	No
ActualClicks	form	ulong	No
JunkClicks	form	ulong	No
SpiderClicks	form	ulong	No
DateUtc	form	DateTime	No

**Item** Parameters:
Name	Parameter	Data Type	Required	Description
Id	form	string	No
DisplayName	form	string	No

**Error** Parameters:
Name	Parameter	Data Type	Required	Description
Code	form	string	No

To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml

HTTP + XML

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /v4/report/links HTTP/1.1 
Host: reporting-api-zane.dev.platform.georiot.com 
Accept: application/xml
Content-Type: application/xml
Content-Length: length

<PostLinkReportRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/ReportingAPI.ServiceModel.V1.Requests">
  <reports xmlns:d2p1="http://schemas.datacontract.org/2004/07/Geniuslink.Reporting.Contracts.V1.DTOs" i:nil="true" />
</PostLinkReportRequest>

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<PostLinkReportResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/ReportingAPI.ServiceModel.V1.Responses">
  <reports xmlns:d2p1="http://schemas.datacontract.org/2004/07/Geniuslink.Reporting.Contracts.V1.DTOs" i:nil="true" />
  <responseStatus xmlns:d2p1="http://schemas.servicestack.net/types">
    <d2p1:ErrorCode>String</d2p1:ErrorCode>
    <d2p1:Message>String</d2p1:Message>
    <d2p1:StackTrace>String</d2p1:StackTrace>
    <d2p1:Errors>
      <d2p1:ResponseError>
        <d2p1:ErrorCode>String</d2p1:ErrorCode>
        <d2p1:FieldName>String</d2p1:FieldName>
        <d2p1:Message>String</d2p1:Message>
        <d2p1:Meta xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
          <d5p1:KeyValueOfstringstring>
            <d5p1:Key>String</d5p1:Key>
            <d5p1:Value>String</d5p1:Value>
          </d5p1:KeyValueOfstringstring>
        </d2p1:Meta>
      </d2p1:ResponseError>
    </d2p1:Errors>
    <d2p1:Meta xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <d3p1:KeyValueOfstringstring>
        <d3p1:Key>String</d3p1:Key>
        <d3p1:Value>String</d3p1:Value>
      </d3p1:KeyValueOfstringstring>
    </d2p1:Meta>
  </responseStatus>
</PostLinkReportResponse>