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
Put the package under your project folder and add the following in import:
"./ai_thirdwatch"
All URIs are relative to https://localhost/event
Class | Method | HTTP request | Description |
---|---|---|---|
AddPromotionApi | AddPromotion | Post /v1/add_promotion | Use add_promotion to record when a user adds one or more promotions to their account. |
AddToCartApi | AddToCart | Post /v1/add_to_cart | Use add_to_cart when a user adds an item to their shopping cart or list. |
ChargebackApi | Chargeback | Post /v1/chargeback | Use chargeback to capture a chargeback reported on a transaction. This event can be called multiple times to record changes to the chargeback state. |
CreateAccountApi | CreateAccount | Post /v1/create_account | Use create_account to pass user details at user registration. |
CreateOrderApi | CreateOrder | Post /v1/createOrder | Submit a new or existing order to Thirdwatch for review. This API should contain order item info, the payment info, and user identity info. |
CustomEventApi | CustomEvent | Post /v1/custom_event | Use order_status to track the order processing workflow of a previously submitted order. |
ItemStatusApi | ItemStatus | Post /v1/item_status | Use item_status to update the status of item that you’ve already pass to Thirdwatch. |
LinkSessionToUserApi | LinkSessionToUser | Post /v1/link_session_to_user | Use link_session_to_user to associate specific session to a user. Generally used only in anonymous checkout workflows. |
LoginApi | Login | Post /v1/login | Use login to record when a user attempts to log in. |
LogoutApi | Logout | Post /v1/logout | Use logout to record when a user logs out. |
OrderStatusApi | OrderStatus | Post /v1/order_status | Use order_status to track the order processing workflow of a previously submitted order. |
RemoveFromCartApi | RemoveFromCart | Post /v1/remove_from_cart | Use remove_from_cart when a user removes an item from their shopping cart or list. |
ReportItemApi | ReportItem | Post /v1/report_item | Use report_item to let us know when another user reports that this item may violate your company’s policies. |
SendMessageApi | SendMessage | Post /v1/send_message | Use send_message to record when a user sends a message to other i.e. seller, support. |
SubmitReviewApi | SubmitReview | Post /v1/submit_review | Use submit_review when a user-submitted review of a product or seller. |
TagAPIApi | TagUser | Post /v1/tag | The Tag API enables you to tell Thirdwatch which of your users are bad and which are good. |
TransactionApi | Transaction | Post /v1/transaction | Use transaction to record attempts results to Pay, Transfer money, Refund or other transactions. |
UntagAPIApi | UnTagUser | Post /v1/untag | If you are unsure whether a user is bad or good, you can always remove tag and leave the user in a neutral state. |
UpdateAccountApi | UpdateAccount | Post /v1/update_account | Use update_account to record changes to the user's account information. |
UpdateOrderApi | UpdateOrder | Post /v1/update_order | Update details of an existing order. |
- AddPromotion
- AddToCart
- BillingAddress
- Chargeback
- CreateAccount
- CreateOrder
- Custom
- CustomInfo
- ErrorResponse
- EventResponse
- Item
- ItemStatus
- LinkSessionToUser
- Login
- Logout
- OrderStatus
- PaymentMethod
- Promotion
- RemoveFromCart
- ReportItem
- Seller
- SendMessage
- ShippingAddress
- SubmitReview
- Tag
- Transaction
- UnTag
- UpdateAccount
- UpdateOrder
- Type: API key
- API key parameter name: X-THIRDWATCH-API-KEY
- Location: HTTP header