In the wake of the reporting changes launched in December, I want to make sure that you are aware of the new API, which will let you and other program admins access new metrics like Grade and Completion Time. If you use direct API integrations, we recommend updating to the new Coursera for Business API as soon as possible. The new API also has improved speed and reliability.
What is changing? The endpoint for consuming our reports is changing from
https://api.coursera.org/api/businesses.v1/[orgId]/enrollment to https://api.coursera.org/api/businesses.v1/[orgId]/enrollmentReports
Reports API provides enrollments and progress for an organization as a whole or a specific program. These are similar to businesses.v1/[orgId]/enrollment but without long latency which results in unreliability. These endpoints rely on data that are at the maximum 24 hrs delayed compared to live data that you get via enrollments endpoint. You can read more information about the changes here.
We will cease support to the current API by June 30, 2019.
Usage of External IDs with APIs
Previously, when inviting a user to one of your enterprise programs, there is an optional field for external ID. In our reporting APIs, if a user was missing an external ID value, we would return the local part of the users email address (for example, with jbloggs@coursera.org we would return `jbloggs`).
Moving forward, If a user is missing an external ID value, we will return the users email address as external ID (for example, with jbloggs@coursera.org we will return `jbloggs@coursera.org`).
This change will not affect you if you are consistently passing a unique value for every user when creating invitations and if you are not separately storing the old external ID values and using it to:
- Remove a user from a program by external ID
- Fetch a specific users enrolments/completions by external ID
This change will be made on the 11th of February 2019.
Resources
Comments
1 comment
Hey guys, why the API docs aren't available for download? What is so secret about them?
Please sign in to leave a comment.