API users

Visitor

GET https://api.commander1.com/v1.0/engage/visitors/

This endpoint allows you to get properties for one specific visitor. When you create the token, you can define which properties to return.

This API is more designed to be called from a tag in each user's browser.

Query Parameters

First-party usage

If your site uses a first-party domain (either through a dedicated subdomain or through the Commanders Act Gateway path), API calls must be made on your own domain.

Important: the URL must include /api/ in the path. Without this path, the request will not work.

1. Using a dedicated subdomain (example: tracking.mydomain.com)

The first-party API structure must follow this pattern: https://tracking.mydomain.com/api/1.0/engage/visitors/

Example: https://tracking.mydomain.com/api/v1.0/engage/visitors/?site=5326&tcid=&token=XXXX

2. Using Commanders Act Gateway (path-based setup)

If your gateway endpoint is served under a path (for example: https://www.mydomain.com/cact-proxy/), the first-party API structure must follow this pattern: https://www.mydomain.com/cact-proxy/api/1.0/engage/visitors/

Example: https://www.mydomain.com/cact-proxy/api/v1.0/engage/visitors/?site=5326&tcid=&token=XXXX

Note: always keep the /api//… structure after the subdomain or the gateway path.

User

GET https://api.commander1.com/engage/user/

This endpoint allows you to get properties for one specific user based on a user_id. When you create the token, you can define which properties to return.

Query Parameters

Do not use this endpoint client-side

The GET User endpoint must not be called from the browser. Exposing the token would allow anyone to capture it and loop through user IDs to extract all user data.

Use this API server-side only in a secure backend environment.

User

PUT https://api.commander1.com/engage/user/

Insert or update a user

Query Parameters

Example Request

PUT

https://api.commander1.com/engage/user/?site=1234&user_id=1234&token=WvNIX8955cnZ7WF0f632s0Wb99Ql3rtA

DELETE user

Delete a user

Resource URL

https://api.commander1.com/engage/user/

Resource Information

Parameters

Example Request

DELETE

https://api.commander1.com/engage/user/?site=1234&user_id=1234&tc_id=1234&token=WvNIX8955cnZ7WF0f632s0Wb99Ql3rtA

Response