Share Course API
This API is used to share courses in LMS.
Request URL:
https://people.zoho.com/api/v1/courses/<courseId>/share
Scope:
ZOHOPEOPLE.training.ALL
OR
ZOHOPEOPLE.training.CREATE
Possible Operation Types:
ALL - Complete access to data
CREATE - Only to create data
Method:
PUT
Request Parameters
| Parameters | Values Allowed | Default Value | Description |
| *erecnosList | <JSON Array of erecno's> | - | Specify employees erecno's |
Error Codes and Descriptions
| Status Codes | Description |
|---|---|
| 400 | Invalid parameter value/input parameter missing |
| 403 | Sorry! You are not authorized to do this operation |
| 404 | Not found |
| 422 | Maximum limit exceeded |
| 500 | Sorry! Server error occured |
View complete list of LMS API error codes
Threshold Limit: 30 requests | Lock period: 5 minutes
Threshold Limit - Number of API calls allowed within a minute.
Lock Period - Wait time before consecutive API requests.
Request
Copiedimport okhttp3.*;
public class Main {
public static void main(String[] args) throws Exception {
OkHttpClient client = new OkHttpClient();
MediaType mediaType = MediaType.parse("application/x-www-form-urlencoded");
RequestBody body = RequestBody.create("erecnosList=%5B588882000000212025%5D", mediaType);
Request request = new Request.Builder()
.url("https://people.zoho.com/api/v1/courses/588882000000289003/share")
.put(body)
.addHeader("Content-Type", "application/x-www-form-urlencoded")
.addHeader("Cookie", "CSRF_TOKEN=****; _zcsr_tmp=****; _zpsid=****; zalb_c7cb34e6ac=****")
.build();
Response response = client.newCall(request).execute();
System.out.println(response.body().string());
}
}Copiedfetch("https://people.zoho.com/api/v1/courses/588882000000289003/share", {
method: "PUT",
headers: {
"Content-Type": "application/x-www-form-urlencoded",
"Cookie": "CSRF_TOKEN=****; _zcsr_tmp=****; _zpsid=****; zalb_c7cb34e6ac=****"
},
body: "erecnosList=%5B588882000000212025%5D"
})
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.error(error));Copiedcurl --location --request PUT 'https://people.zoho.com/api/v1/courses/588882000000289003/share' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Cookie: CSRF_TOKEN=****; _zcsr_tmp=****; _zpsid=****; zalb_c7cb34e6ac=****' \
--data-urlencode 'erecnosList=[588882000000212025]'Copiedresponse = invokeurl
[
url: "https://people.zoho.com/api/v1/courses/588882000000289003/share"
type: PUT
parameters: {
"erecnosList": "[588882000000212025]"
}
headers: {
"Content-Type": "application/x-www-form-urlencoded",
"Cookie": "CSRF_TOKEN=****; _zcsr_tmp=****; _zpsid=****; zalb_c7cb34e6ac=****"
}
];
info response;Copiedimport requests
url = "https://people.zoho.com/api/v1/courses/588882000000289003/share"
payload = "erecnosList=%5B588882000000212025%5D"
headers = {
"Content-Type": "application/x-www-form-urlencoded",
"Cookie": "CSRF_TOKEN=****; _zcsr_tmp=****; _zpsid=****; zalb_c7cb34e6ac=****"
}
response = requests.put(url, headers=headers, data=payload)
print(response.text)Show full
Show less
Header
CopiedAuthorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxx9be93.9b8xxxxxxfResponse
Copied{
"sharedUsers": [
{
"erecno": "219225000000185023",
"displayName": "Henry",
"employeeId": "1001",
"emailId": "henry@�zohotest.com",
"displayPictureURL": "https://contacts.zoho.com/file?ID=705822094&fs=thumb"
}
],
"code": "200",
"message": "success"
}