<![CDATA[
# DeviceAtlas Enterprise API Installation #
This section deals with installing the DeviceAtlas Enterprise API.
### Dependencies ###
This library does not depend on any third party libraries.
### Library ###
The DeviceAtlas Enterprise API consists of three libraries and each
library has a separate DLL file.
#### DeviceAtlas Enterprise API (deviceatlas-enterprise-dotnet-3.1.7.dll) ####
This library contains the DeviceAtlas Device and Carrier APIs.
Device detection is achieved by passing a set of request headers or a
user-agent along with optional Client-side properties. Carrier detection
is achieved by passing a set of request headers or an IP address.
The target framework for this library is netstandard2.0 .
#### DeviceAtlas Enterprise API Web (deviceatlas-enterprise-dotnet-web-3.1.7.dll) ####
This is an extension of the above library to allow passing of a
`HttpRequest` object. The library will automatically use the necessary
headers from the `HttpRequest` object to perform the device
identification. In a web context, it is recommended to pass the full
`HttpRequest` object rather than individual User-Agents to the library.
The target framework for this library is netcoreapp2.0 .
#### DeviceAtlas Enterprise API Web (deviceatlas-enterprise-dotnet-framework-3.1.7.dll) ####
This library contains the DeviceAtlas Device and Carrier APIs with support for
.NET Frameworks version 4.0 and higher. The web extensions are included in this
library.
The target framework for this library is v4.0 .
### Configuration ###
The usage of the DeviceAtlas server side library is straightforward. In all
cases, the data file must be loaded before any device identification calls are
made.
> **Note:** It is highly recommended to ensure the data file is only loaded once.
This is particularly important for batch processing and web applications.
#### Include Dependencies ####
The DeviceAtlas API dll files must be included as dependencies.
The example below shows how to include these in your application.
##### CLI Applications #####
```xml
<ItemGroup>
<Reference Include="deviceatlas-enterprise-dotnet">
<HintPath>\path\to\deviceatlas-enterprise-dotnet-3.1.7.dll</HintPath>
</Reference>
</ItemGroup>
```
##### Web Applications #####
```xml
<ItemGroup>
<Reference Include="deviceatlas-enterprise-dotnet-web">
<HintPath>\path\to\deviceatlas-enterprise-dotnet-web-3.1.7.dll</HintPath>
</Reference>
</ItemGroup>
```
##### .NET Framework (CLI & Web) Applications #####
```xml
<ItemGroup>
<Reference Include="deviceatlas-enterprise-dotnet-framework">
<HintPath>\path\to\deviceatlas-enterprise-dotnet-framework-3.1.7.dll</HintPath>
</Reference>
</ItemGroup>
```
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
_ Copyright (c) DeviceAtlas Limited 2023. All Rights Reserved. _
_ https://deviceatlas.com _
<!-- HTML+JS for document formatting when opened in browser -->
<div class="btn-group" id="main-menu" style="float:right"><a class="btn dropdown-toggle" data-toggle="dropdown" href="#">Menu<span class="caret"></span></a><ul class="dropdown-menu"><li><a href="README.html">Main</a></li><li class="disabled"><a href="README.Installation.html">Enterprise API Installation</a></li><li><a href="README.DataFileConfig.html">Data File Configuration</a></li><li><a href="README.DeviceApi.html">Device Identification API</a></li><li><a href="README.CarrierApi.html">Carrier Identification API</a></li><li><a href="README.ClientHints.html">Client Hints Support</a></li><li><a href="README.Upgrade.html">Device API Upgrade</a></li><li class="divider"></li><li><a href="./DeviceApiDocs/classes.html">Device API Docs</a></li><li><a href="./CarrierApiDocs/classes.html">Carrier API Docs</a></li></ul></div>]]>