Webhooks are arbitrary URLs which handle HTTP POST requests allowing Memsource to notify 3rd-party systems about specified events.
Memsource monitors if a webhook callback was successfully received. If a webhook reception fails 3000 times, it is deactivated with a notification sent to Administrators of the account and the failure is noted on the specific webhook on the
page. The retry mechanism has a maximum of 10 retries with the interval between retries being computed up to a maximum value of 30 minutes.Webhooks can be selected for the following events:
Job status changed
Job created
Job assigned
Job due date changed
Job updated
Project created
Project status changed
Project due date changed
Project template created
Project template changed
Project template deleted
Shared project assigned
Project metadata updated
Pre-translation finished
Analysis created
Continuous job updated
To configure Webhooks, follow these steps:
A website called RequestBin will provide a URL to used when creating a webhook.
The next time a Job Status is changed or a Job is created in the Memsource account, the URL receives the appropriate response from the system. Actual usage can be more complex and the receiving of the response should be considered a signal for the connected application to perform certain actions.
Events
Examples of a job status change, a job assignment, job creation and when a job's due date is changed.
Job status has changed
{ "jobParts": [ { "id": 9, "uid": "ipmdz5p0sagqcOYaijTZU2", "internalId": "4", "task": "SEfSaenvqFgctE1I0_dc1", "fileName": "en.txt", "targetLang": "af", "workflowLevel": 1, "status": "NEW", "wordsCount": 2, "beginIndex": 0, "endIndex": 1, "isParentJobSplit": false, "dateDue": null, "dateCreated": "2016-11-02T17:06:54Z", "project": { "id": 2 }, "assignedTo": [ { "vendor": { "id": 1, "name": "Abc", "vendorToken": "4-ifos0-CAqPo" } }, { "linguist": { "id": 3, "firstName": "Admin", "lastName": "Admin", "userName": "admin", "email": "admin@example.com", "role": "ADMIN", "timezone": "Europe/London", "active": true, "deleted": false, "terminologist": false, "dateCreated": "2016-10-11T07:43:22Z" } } ] } ], "event": "JOB_STATUS_CHANGED" }
Job Assigned
{ "jobParts": [ { "id": 9, "uid": "ipmdz5p0sagqcOYaijTZU2", "internalId": "4", "task": "SEfSaenvqFgctE1I0_dc1", "fileName": "en.txt", "targetLang": "af", "workflowLevel": 1, "status": "NEW", "wordsCount": 2, "beginIndex": 0, "endIndex": 1, "isParentJobSplit": false, "dateDue": null, "dateCreated": "2016-11-02T17:06:54Z", "project": { "id": 2 }, "assignedTo": [ { "vendor": { "id": 1, "name": "Abc", "vendorToken": "4-ifos0-CAqPo" } }, { "linguist": { "id": 3, "firstName": "Admin", "lastName": "Admin", "userName": "admin", "email": "admin@example.com", "role": "ADMIN", "timezone": "Europe/London", "active": true, "deleted": false, "terminologist": false, "dateCreated": "2016-10-11T07:43:22Z" } } ] } ], "event": "JOB_ASSIGNED" }
Job Created
{ "jobParts": [ { "id": 9, "uid": "ipmdz5p0sagqcOYaijTZU2", "internalId": "4", "task": "SEfSaenvqFgctE1I0_dc1", "fileName": "en.txt", "targetLang": "af", "workflowLevel": 1, "status": "NEW", "wordsCount": 2, "beginIndex": 0, "endIndex": 1, "isParentJobSplit": false, "dateDue": null, "dateCreated": "2016-11-02T17:06:54Z", "project": { "id": 2 }, "assignedTo": [ { "vendor": { "id": 1, "name": "Abc", "vendorToken": "4-ifos0-CAqPo" } }, { "linguist": { "id": 3, "firstName": "Admin", "lastName": "Admin", "userName": "admin", "email": "admin@example.com", "role": "ADMIN", "timezone": "Europe/London", "active": true, "deleted": false, "terminologist": false, "dateCreated": "2016-10-11T07:43:22Z" } } ] } ], "event": "JOB_CREATED" }
Job Due Date Changed
{ "jobParts": [ { "id": 127865777, "uid": "ElTXvXnNIHEN2xgL5sU2L2", "internalId": "1", "task": "LvkAHilgobApeoVm_dc4", "fileName": "EU White Paper Edited.doc", "targetLang": "de", "workflowLevel": 1, "status": "NEW", "wordsCount": 204, "beginIndex": 0, "endIndex": 16, "isParentJobSplit": false, "dateDue": "2018-09-11T22:00:00Z", "dateCreated": "2018-09-10T06:25:41Z", "project": { "id": 12277756, "lastWorkflowLevel": 1 }, "assignedTo": [] } ], "event": "JOB_DUE_DATE_CHANGED" }
Comments
Article is closed for comments.