The RudderStack API Spec helps you plan your event data and provides various options for tracking your events across all the RudderStack SDKs and APIs.
RudderStack has a unified event semantic for different destination platforms. You can easily translate your event data to different downstream tools by following this spec.
The RudderStack API Spec supports the following calls, each answering a pertinent question about the user:
|Identify||Captures the details about the user.|
|Page||Captures the details related to the web page that the user is currently on.|
|Screen||Captures the details related to the app screen that the user is currently viewing.|
|Track||Captures information related to the user's actions.|
|Group||Captures the relevant details about the group or organization that the user is a part of.|
|Alias||Captures any relevant details about the user's alternate/past identity.|
|Reset||Resets the information related to the previously identified user.|
Here's a quick overview of how the API calls mentioned above work:
- When the user makes the API calls, the event data is sent to the RudderStack backend.
- RudderStack transforms this event data into a destination-specific format.
- The transformed data is then forwarded to the required destination.
The event data collected by RudderStack has a JSON structure, which has common fields and an API-specific payload.