Account
An established relationship between an User and the System
| API | Description |
|---|---|
| GET Api/v{apiVersion}/Account |
Gets the current account details |
| PUT Api/v{apiVersion}/Account |
Updates the account |
| POST Api/v{apiVersion}/Account/Login |
Validates an e-mail address and password combination, returns detailed results |
| POST Api/v{apiVersion}/Account/ResetPassword |
Resets the User password with a reset token send by e-mail |
| POST Api/v{apiVersion}/Account/ForgotPassword |
Enqueues an e-mail message with instructions to reset the Users password |
| POST Api/v{apiVersion}/Account?operatorID={operatorID} |
Creates a new account |
| POST Api/v{apiVersion}/Account/MailUnsubscribe?userid={userid} |
Sets the IsMailSubscribed value to false for the current user |
AdLocations
An AdLocation is a particular place for advertising space
Areas
An Area is a particular part of a place, in this scope: Neighbourhood, Postcode area, Locality, District, Region or Country
CampaignBudgets
Budgets to a Campaign (e.g. exclude a Medium from being offered)
| API | Description |
|---|---|
| GET Api/v{apiVersion}/CampaignBudgets/{id} |
Gets the campaignbudget details |
| PUT Api/v{apiVersion}/CampaignBudgets/{id} |
Updates a campaignbudget |
| POST Api/v{apiVersion}/CampaignBudgets |
Creates a new campaignbudget |
| DELETE Api/v{apiVersion}/CampaignBudgets/{id} |
Removes a campaignbudget |
CampaignExceptions
Exceptions to a Campaign (e.g. exclude a Medium from being offered)
| API | Description |
|---|---|
| GET Api/v{apiVersion}/CampaignExceptions/{id} |
Gets the campaignexception details |
| PUT Api/v{apiVersion}/CampaignExceptions/{id} |
Updates a campaignexception |
| POST Api/v{apiVersion}/CampaignExceptions |
Creates a new campaignexception |
| DELETE Api/v{apiVersion}/CampaignExceptions/{id} |
Removes a campaignexception |
Campaigns
A Campaign is a predefined period in where Stores are offered to Order Mediums
Categories
A Category distinguishes one Medium from the other
| API | Description |
|---|---|
| GET Api/v{apiVersion}/Categories/{id} |
Gets the category details |
| GET Api/v{apiVersion}/Categories?query={query}&pageSize={pageSize}¤tPage={currentPage}&orderBy={orderBy}&descending={descending} |
Gets a list of categories |
| PUT Api/v{apiVersion}/Categories/{id} |
Updates a category |
| POST Api/v{apiVersion}/Categories |
Creates a new category |
| DELETE Api/v{apiVersion}/Categories/{id} |
Removes a category |
Coverages
A Coverage is the way in which Mediums are shared out among a group or spread over an Area
| API | Description |
|---|---|
| GET Api/v{apiVersion}/Coverages/{id} |
Gets the coverage details |
| GET Api/v{apiVersion}/Coverages/{id}/AsGeoJson |
Gets the object in GeoJSON format |
| GET Api/v{apiVersion}/Coverages?query={query}&pageSize={pageSize}¤tPage={currentPage}&orderBy={orderBy}&descending={descending} |
Gets a list of coverages |
| GET Api/v{apiVersion}/Coverages/AsGeoJson?query={query}&pageSize={pageSize}¤tPage={currentPage}&orderBy={orderBy}&descending={descending} |
Gets a list of coverages in GeoJSON format |
| PUT Api/v{apiVersion}/Coverages/{id} |
Updates a coverage |
| POST Api/v{apiVersion}/Coverages |
Creates a new coverage |
| POST Api/v{apiVersion}/Coverages/Upload |
Creates new coverages from Excel upload |
| DELETE Api/v{apiVersion}/Coverages/{id} |
Removes a coverage |
Customers
An Customer is a company who buys the services this platform offers
Errors
An Error is advertising space in a given Medium and in a particular Area, available to be bought by a Store
| API | Description |
|---|---|
| GET Api/v{apiVersion}/Errors/{id} |
Gets the Error details |
| GET Api/v{apiVersion}/Errors?query={query}&pageSize={pageSize}¤tPage={currentPage}&orderBy={orderBy}&descending={descending} |
Gets a list of Errors |
| PUT Api/v{apiVersion}/Errors/{id} |
Updates a Error |
| POST Api/v{apiVersion}/Errors |
Creates a new Error |
| DELETE Api/v{apiVersion}/Errors/{id} |
Removes a Error |
Features
A Feature is a distinctive characteristic of an Area that sets it apart from similar Areas.
| API | Description |
|---|---|
| GET Api/v{apiVersion}/Features/{id} |
Gets the store details |
| GET Api/v{apiVersion}/Features/{id}/AsGeoJson |
Gets the object in GeoJSON format |
| GET Api/v{apiVersion}/Features?query={query}&pageSize={pageSize}¤tPage={currentPage}&orderBy={orderBy}&descending={descending} |
Gets a list of stores |
| GET Api/v{apiVersion}/Features/AsGeoJson?query={query}&pageSize={pageSize}¤tPage={currentPage}&orderBy={orderBy}&descending={descending} |
Gets a list of stores in GeoJSON format |
| PUT Api/v{apiVersion}/Features/{id} |
Updates a store |
| POST Api/v{apiVersion}/Features |
Creates a new store |
| DELETE Api/v{apiVersion}/Features/{id} |
Removes a store |
Files
A File is a document stored in the system
| API | Description |
|---|---|
| GET Api/v{apiVersion}/Files/{id} |
Gets the file details |
| GET Api/v{apiVersion}/files/{id}/blob?openInline={openInline} |
Gets the file bytes |
| GET Api/v{apiVersion}/files/blob?linkedentityid={linkedentityid}&propertyName={propertyName}&openInline={openInline} |
Gets the file bytes |
| PUT Api/v{apiVersion}/Files/{id} |
Updates a file |
| POST Api/v{apiVersion}/Files |
Creates a new file |
| DELETE Api/v{apiVersion}/Files/{id} |
Removes a file |
ImportJobs
An ImportJob is background job for importing excel data
LinkedEntities
A LinkedEntity is an entity which is linked to a User (Operator, Customer, Supplier or Store)
| API | Description |
|---|---|
| GET Api/v{apiVersion}/LinkedEntities?query={query}&pageSize={pageSize}¤tPage={currentPage}&orderBy={orderBy}&descending={descending} |
Gets a list of campaigns |
Maps
A Map is a diagrammatic representation of an Area showing Features, Coverages and AdLocations
Mediums
A Medium is the intervening substance through which sensory impressions are conveyed or physical forces are transmitted
Messages
A Message is a written and recorded communication sent to or left for a User
| API | Description |
|---|---|
| GET Api/v{apiVersion}/Messages/{id} |
Gets the message details |
| GET Api/v{apiVersion}/Messages?query={query}&pageSize={pageSize}¤tPage={currentPage}&orderBy={orderBy}&descending={descending} |
Gets a list of messages |
| PUT Api/v{apiVersion}/Messages/{id} |
Updates a message |
| POST Api/v{apiVersion}/Messages |
Creates a new message |
| DELETE Api/v{apiVersion}/Messages/{id} |
Removes a message |
Offers
An Offer is advertising space in a given Medium and in a particular Area, available to be bought by a Store
| API | Description |
|---|---|
| GET Api/v{apiVersion}/Offers/{id} |
Gets the offer details |
| GET Api/v{apiVersion}/Offers/{id}/AsGeoJson?areaid={areaid} |
Gets the offer in GeoJSON format |
| GET Api/v{apiVersion}/Offers/{id}/Rates?query={query}&pageSize={pageSize}¤tPage={currentPage}&orderBy={orderBy}&descending={descending} |
Gets a list of rates for a particular offer |
| GET Api/v{apiVersion}/Offers?storeid={storeid}&campaignid={campaignid}&query={query}&pageSize={pageSize}¤tPage={currentPage}&orderBy={orderBy}&descending={descending} |
Gets a list of offers |
| PUT Api/v{apiVersion}/Offers/{id} |
Updates a offer |
| POST Api/v{apiVersion}/Offers |
Creates a new offer |
| DELETE Api/v{apiVersion}/Offers/{id} |
Removes a offer |
Operators
An Operator is the instance that facilitates the System for its Customers
| API | Description |
|---|---|
| GET Api/v{apiVersion}/Operators/{id} |
Gets the operator details |
| GET Api/v{apiVersion}/Operators?query={query}&pageSize={pageSize}¤tPage={currentPage}&orderBy={orderBy}&descending={descending} |
Gets a list of operators |
| PUT Api/v{apiVersion}/Operators/{id} |
Updates an operator |
| POST Api/v{apiVersion}/Operators |
Creates a new operator |
| DELETE Api/v{apiVersion}/Operators/{id} |
Removes an operator |
OrderItems
An OrderItem is a detailed item of an Order, containing a Medium, Unit and a Price.
| API | Description |
|---|---|
| GET Api/v{apiVersion}/OrderItems/{id} |
Gets the orderitem details |
| PUT Api/v{apiVersion}/OrderItems/{id} |
Updates a orderitem |
| POST Api/v{apiVersion}/OrderItems |
Creates a new orderitem |
| POST Api/v{apiVersion}/OrderItems?offerid={offerid}&storeid={storeid}&orderid={orderid}&campaignid={campaignid}&numberOfPieces={numberOfPieces}&preferredStartDate={preferredStartDate} |
Creates an new OrderItem for an Offer |
| DELETE Api/v{apiVersion}/OrderItems/{id} |
Removes a orderitem |
Orders
An Order is a request for a Store containing 1 or multiple OrderItems
| API | Description |
|---|---|
| GET Api/v{apiVersion}/Orders/{id} |
Gets the order details |
| GET Api/v{apiVersion}/Orders/Current?storeid={storeid}&offerid={offerid}&campaignid={campaignid} |
Gets the current order details |
| GET Api/v{apiVersion}/Orders?query={query}&pageSize={pageSize}¤tPage={currentPage}&orderBy={orderBy}&descending={descending} |
Gets a list of orders |
| GET Api/v{apiVersion}/Orders/{id}/OrderItems?query={query}&pageSize={pageSize}¤tPage={currentPage}&orderitemBy={orderitemBy}&descending={descending} |
Gets a list of orderitems |
| PUT Api/v{apiVersion}/Orders/{id} |
Updates a order |
| POST Api/v{apiVersion}/Orders |
Creates a new order |
| PATCH Api/v{apiVersion}/Orders/{id}?property={property}&value={value} |
Patches an order |
| DELETE Api/v{apiVersion}/Orders/{id} |
Removes a order |
Rates
An Rate is advertising space in a given Medium and in a particular Area, available to be bought by a Store
| API | Description |
|---|---|
| GET Api/v{apiVersion}/Rates/{id} |
Gets the rate details |
| GET Api/v{apiVersion}/Rates?query={query}&pageSize={pageSize}¤tPage={currentPage}&orderBy={orderBy}&descending={descending} |
Gets a list of rates |
| PUT Api/v{apiVersion}/Rates/{id} |
Updates a rate |
| POST Api/v{apiVersion}/Rates |
Creates a new rate |
| DELETE Api/v{apiVersion}/Rates/{id} |
Removes a rate |
Reports
...
| API | Description |
|---|---|
| GET Api/v{apiVersion}/Reports/StoresWithBudgetAvailable?campaignEndDate={campaignEndDate}&query={query}&pageSize={pageSize}¤tPage={currentPage}&orderBy={orderBy}&descending={descending} |
Gets a list of Stores with budget available per Campaign |
| GET Api/v{apiVersion}/Reports/StoresWithoutActiveOffers?customerid={customerid}&mediumid={mediumid}&query={query}&pageSize={pageSize}¤tPage={currentPage}&orderBy={orderBy}&descending={descending} |
Gets a list of Stores without active Offers |
Settings
A Setting is a value at which the system can be adjusted to operate
| API | Description |
|---|---|
| GET Api/v{apiVersion}/Settings/{id} |
Gets the setting details |
| GET Api/v{apiVersion}/Settings?query={query}&pageSize={pageSize}¤tPage={currentPage}&orderBy={orderBy}&descending={descending} |
Gets a list of settings |
| PUT Api/v{apiVersion}/Settings/{id} |
Updates an setting |
Stores
A Store is a shop of any size or kind owned by a Customer
Suppliers
An Supplier is a person or organization that provides Mediums
| API | Description |
|---|---|
| GET Api/v{apiVersion}/Suppliers/{id} |
Gets the supplier details |
| GET Api/v{apiVersion}/Suppliers/{id}/Logo |
Gets the logo details for this object |
| GET Api/v{apiVersion}/Suppliers?query={query}&pageSize={pageSize}¤tPage={currentPage}&orderBy={orderBy}&descending={descending} |
Gets a list of suppliers |
| GET Api/v{apiVersion}/Suppliers/{id}/Mediums?query={query}&pageSize={pageSize}¤tPage={currentPage}&orderBy={orderBy}&descending={descending} |
Gets a list of mediums |
| GET Api/v{apiVersion}/Suppliers/{id}/Children?query={query}&pageSize={pageSize}¤tPage={currentPage}&orderBy={orderBy}&descending={descending} |
Gets a list of child objects |
| PUT Api/v{apiVersion}/Suppliers/{id} |
Updates a supplier |
| POST Api/v{apiVersion}/Suppliers |
Creates a new supplier |
| POST Api/v{apiVersion}/Suppliers/{id}/UpdateCirculations?totalCirculationValue={totalCirculationValue} |
Updates all Circulation Values of the Coverages |
| DELETE Api/v{apiVersion}/Suppliers/{id} |
Removes a supplier |
Users
An instance of a person who uses a the System. An User can identify itself by e-mail address and password
| API | Description |
|---|---|
| GET Api/v{apiVersion}/Users/{id} |
Gets the user details |
| GET Api/v{apiVersion}/Users?query={query}&pageSize={pageSize}¤tPage={currentPage}&orderBy={orderBy}&descending={descending} |
Gets a list of users |
| PUT Api/v{apiVersion}/Users/{id} |
Updates an user |
| POST Api/v{apiVersion}/Users |
Creates a new user |
| DELETE Api/v{apiVersion}/Users/{id} |
Removes an user |