- Get Started
- Write Code
For xAPI to succeed, there needs to be shared agreement of how we talk about a specific type of experience. That’s what xAPI Recipes are for.
A Recipe is a standard way of expressing a particular type of experience. It provides a common language and prevents the use of different words saying the same thing.
Suppose that YouTube and Vimeo both wanted to express that a person interacted with a video. Each one might talk about the same activities in very different ways:
Tim Martin watched “How to make Grilled Cheese”
Tim Martin launched “How to Make Grilled Cheese”
Same experiences, different statements. This makes reporting difficult. But, If both these systems used the video Recipe, their statements would look the same. Recipes allow different systems to talk about things people do using the same words.
Basically, a Recipe specifies which verbs and activity types and extensions and the like to use and how to use them for a given experience. No need to start from scratch. To read about the deep details about how a Recipe works, go here.
For xAPI to succeed we need to create consistency for how statements are expressed. It makes life easier for authors of statements because they don’t have to blaze a trail and simplifies reporting for LRSs because they can expect more consistency of expression.
Anything that is going to be expressed through xAPI by more than one system should have a Recipe. Right now, Recipes will be small and few. They will grow through subsequent versions as communities of practices become more prevalent.
We’ve compiled a summary of available recipes and expect this list to grow and grow!
Recipes aren’t going to happen independently—they need input from the community. Add requests for subsequent Recipes, comment on existing ones, and share Recipes you are working on.
When you are ready to take the next step and create a Recipe, it’s easy to get started on the xAPI Registry, where the Recipes live.
If you want to read more about Recipes and why they are important, take a look at the resources below.