Page Comparison

Problem Statement

...

Solution approach to overcome the problem has below componentsapproaches

APPROACH 1

1. Sunbird Platform will expose an API for end user to initiate update content
2. Sunbird Platform will log the request in DB and pass the user a generated process Id
3. Sunbird Platform will send the request with processId to kafka message queue
4. Request will be picked up by Learning platform and would start the processing of update content based on the request
5. Sunbird Platform will use a listener to get the status update and store in DB from the kafka based on processId

Approach 2

1. Sunbird Platform will expose an API for end user to initiate update content
2. Sunbird Platform will internally call Content Service with the request provided by User.
3. Content Service will validate the requestWith valid request, Content Service will initiate the update process through kafka pipeline and will return unique process ID identifying the process.
4. With Invalid request, Content Service will return error message which Sunbird platform will return to User
5. For valid response from Content Service, processId with other details will be saved in Sunbird platform DB
6. On user call to get status, Sunbird Platform will call Content Service. 

pros and cons of both approaches

Problem Statement

What is the API for update content?

Solution approach

URL:

POST /v1/contentjob/updatestart

Headers:

Authorization

X-authenticated-user-token

Request Params:

Response Params:

Errors:

Sample Request and Response:

Request

{
	request : {
		"scriptscriptName" : "course_rename",
		"version" : "1.2",
		"attributes" : [{
			"field" : "name"
			"oldValue" : "AB",
			"newValue" : "ab"
		},{
			"contentfield" : "orgDetails"
			"oldValue" : {
				"oldNamecourseName" : "AB"
			},
			"newNamenewValue" : {
				"courseName" : "ab"
			}
		}]	
	}
}

Response

{
  "id": "api.content.updatejob",
  "result": {
		"processId" : "01262366359399628812"
	}
}

...

content_update_process table structure should be as below

Problem Statement

What is the API for getting the process status

Solution approach

URL:job

GET /v1/contentjob/update/status/{processId}

Headers:

Authorization

X-authenticated-user-token

Request Params:

None

Response Params:

Errors:

Sample Request and Response:

Request

GET /v1/contentjob/update/status/01262366359399628812

Response

{
  "id": "api.contentjob.update.status",
  "result": {
		"status" : "FAILURE",
		"message" : "Operation to update failed"
	}
}

Problem Statement

What is the API for get all the processes by a user

Solution approach

URL:

GET /v1/job/list

Headers:

Authorization

X-authenticated-user-token

Request Params:

None

Response Params:

returns an array of processes related to user

Errors:

None

Sample Request and Response:

Request

GET /v1/job/processes

Response

{
  "id": "api.job.processes",
  "result": {
		processes : [{
			"processId" : "01262366359399628812",
			"script" : "course_rename",
			"version" : "1.2"
		}]
	}
}

Deprecated SOLUTION APPROACH

...