TCA Basics
What file formats does TCA Support?
TCA Supports .pdf, .doc, .ppt, .pps, .xls, .docx, .pptx, .ppsx, .xlsx, .xls, .ps, .rtf, .htm, .html, .wpd, .odt, .txt, .hwp, .hwpx
What languages are available for the EULA and Viewer?
The Turnitin EULA and viewer is currently available in English, Dutch, German, Norwegian, Danish, Swedish, French, and Spanish with further languages to follow.
What is the maximum file upload size for TCA?
The maximum file upload size is 100MB. There is a limit of 800 pages or 2MB of raw text.
Features
I've updated 'exclude_small_matches' to a value of 20 in the 'Generate Report' endpoint but it has no effect. I still see the same small matches?
'exclude_small_matches' is only available under certain licenses. If you do not have a license that allows you to change the value then a default of 8 is used. You can use the 'Get Features Enabled' endpoint to show what your license has access to.
How do I know which API features my license supports?
You can call the 'Get Features Enabled' endpoint documented in the API reference
Other
What values should I use for the X-Turnitin-Integration-Name and X-Turnitin-Integration-Version headers in my requests?
Use the name of your LMS, (or software) for X-Turnitin-Integration-Name and the version of your LMS, (or software) for X-Turnitin-Integration-Version. Do not use things like, 'Live' and 'Test' for X-Turnitin-Integration-Name and always ensure you update X-Turnitin-Integration-Version if you update your LMS, (or software).
What are 'Integration Instances' detailed in the API Reference and why do I need them?
An API key exists under an integration instance and you can have multiple 'Integration Instances' per tenant, (Sandbox and Production). All data created within an instance of an integration (as created in the Turnitin administrator area) belongs to that integration instance and can only be accessed by API keys that belong to that integration instance.
When should I use the Indexing option for submissions?
Indexing a submission makes that submission available for matching for future submissions. If you don't want the submission to be matched against future submissions then set the flag to false and alternatively true if you do want it matched against future submissions.
What mime types does TCA Support?
The 'Upload Submission' endpoint requires that all requests are made with the Content-Type header set to binary/octet-stream. TCA uses its own methods to determine the MIME type of the uploaded file and supports the following mime types
- application/pdf
- application/msword
- application/vnd.ms-powerpoint
- application/vnd.ms-excel
- application/vnd.openxmlformats-officedocument.wordprocessingml.document
- application/vnd.openxmlformats-officedocument.presentationml.presentation
- application/vnd.openxmlformats-officedocument.presentationml.slideshow
- application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
- application/postscript
- text/rtf
- application/rtf
- text/html
- application/wordperfect
- application/vnd.oasis.opendocument.text
- text/plain
- application/x-hwp