API Designed for Ease
We have optimized for ease of implementation. All API methods are accessible via simple HTTP calls. Most implementations of this API take less than 15 minutes to setup. Simply call the provided URLs with their respective parameters, and you're done.
Getting Started: Authentication
In order for you to use this service, we need to whitelist your redirect URL (r
). If you're interested in using this service, please contact your Shareaholic contact or contact us.
Parameters
Endpoint:https://pixel.shareaholic.com/sync/
Parameter | Description | Required | Example |
---|---|---|---|
r |
Redirect URL | Required | r=https://www.yourdomain.com/?id=$u_id (should be URL-encoded) |
Upon receiving the request for the tag from the user's browser, the service issues a 302 redirect to the specified redirect URL (r
). This 302 redirect includes the Shareaholic UUID ($u_id
). We recommend storing the exact string returned by the Identity Match service in your match table.
Working Example:
For example, you could supply the following redirect URL (r
):
https://pixel.shareaholic.com/sync?r=https://example.com/partners_api?partner_uid=$u_id
The service would then redirect to a URL (r
) like this:
https://example.com/partners_api?partner_uid=123456789
(This 302 redirect includes the Shareaholic UUID, which in this example is 123456789
)