ThirdwatchApi - the C# library for the Thirdwatch API

The first version of the Thirdwatch API is an exciting step forward towards making it easier for developers to pass data to Thirdwatch.

Once you've registered your website/app it's easy to start sending data to Thirdwatch. All endpoints are only accessible via https and are located at api.thirdwatch.ai. For instance: you can send event at the moment by HTTPS POST request to the following URL with your API key in Header and JSON data in request body.

https://api.thirdwatch.ai/event/v1

Every API request must contain API Key in header value X-THIRDWATCH-API-KEY. Every event must contain your _userId (if this is not available, you can alternatively provide a _sessionId value also in _userId).

• API version: 0.0.1
• SDK version: 0.0.1
• Build package: io.swagger.codegen.languages.CSharpClientCodegen

• .NET 4.0 or later
• Windows Phone 7.1 (Mango)

• RestSharp - 105.1.0 or later
• Json.NET - 7.0.0 or later
• JsonSubTypes - 1.2.0 or later

The DLLs included in the package may not be the latest version. We recommend using [NuGet] (https://docs.nuget.org/consume/installing-nuget) to obtain the latest version of the packages:

Install-Package RestSharp
Install-Package Newtonsoft.Json
Install-Package JsonSubTypes

NOTE: RestSharp versions greater than 105.1.0 have a bug which causes file uploads to fail. See RestSharp#742

Run the following command to generate the DLL

• [Mac/Linux] /bin/sh build.sh
• [Windows] build.bat

Then include the DLL (under the bin folder) in the C# project, and use the namespaces:

using ai.thirdwatch.Api;
using ai.thirdwatch.Client;
using ai.thirdwatch.Model;

A .nuspec is included with the project. You can follow the Nuget quickstart to create and publish packages.

This .nuspec uses placeholders from the .csproj, so build the .csproj directly:

nuget pack -Build -OutputDirectory out ai.thirdwatch.csproj

Then, publish to a local feed or other host and consume the new package via Nuget as usual.

using System;
using System.Diagnostics;
using ai.thirdwatch.Api;
using ai.thirdwatch.Client;
using ai.thirdwatch.Model;

namespace Example
{
    public class Example
    {
        public void main()
        {

            // Configure API key authorization: api_key
            Configuration.Default.ApiKey.Add("X-THIRDWATCH-API-KEY", "YOUR_API_KEY");
            // Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
            // Configuration.Default.ApiKeyPrefix.Add("X-THIRDWATCH-API-KEY", "Bearer");

            var apiInstance = new AddPromotionApi();
            var JSON = new AddPromotion(); // AddPromotion | Pass added promotion info to thirdwatch. Only `_userID` is required field. But this should contain promotion info.

            try
            {
                // Use add_promotion to record when a user adds one or more promotions to their account.
                EventResponse result = apiInstance.AddPromotion(JSON);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling AddPromotionApi.AddPromotion: " + e.Message );
            }

        }
    }
}

All URIs are relative to https://api.thirdwatch.ai/event

• Model.AddPromotion
• Model.AddToCart
• Model.BillingAddress
• Model.Chargeback
• Model.CreateAccount
• Model.CreateOrder
• Model.Custom
• Model.CustomInfo
• Model.ErrorResponse
• Model.EventResponse
• Model.Item
• Model.ItemStatus
• Model.LinkSessionToUser
• Model.Login
• Model.Logout
• Model.OrderStatus
• Model.PaymentMethod
• Model.Promotion
• Model.RemoveFromCart
• Model.ReportItem
• Model.Seller
• Model.SendMessage
• Model.ShippingAddress
• Model.SubmitReview
• Model.Tag
• Model.Transaction
• Model.UnTag
• Model.UpdateAccount
• Model.UpdateOrder

• Type: API key
• API key parameter name: X-THIRDWATCH-API-KEY
• Location: HTTP header