Skip to content
Lodle edited this page May 13, 2014 · 4 revisions

Table of Contents

Update Crashdump with Processed Data

This is used to upload a processed crashdump back to the server.

Input

URL

 * http://api.desura.com/1/crashupdate

Post

 * id: Required, This is the dump id
 * report: Required, string. This is the complete dump output
 * username: Not Required, String. Username of a Desura account
 * password: Not Required, String. Password (or password hash) for that account
   * OR
 * token: Not Required, String. Security Token (contact Scott for it)

Process

 1. If the username '''AND''' password is provided attempt to login the user
 1. When wanting to upload a processed crash dump report this API is called
   * Only users with application admin writing permission can access this API, otherwise a 108 (permission error) being thrown.
   * Invalid data will result in a 107 (validation error) being thrown.
   * Any other errors will result in a 100 (generic error) message being thrown.
 1. If a valid data is provided, 0 (ok) will be returned

Output

0: Ok

<?xml version="1.0" encoding="utf-8"?> 
<crashupdate xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="desura" version="1">
 	<status code="0"/>
	<passed /> 
</crashupdate>

0: Ok (curropt crashdump)

<?xml version="1.0" encoding="utf-8"?> 
<crashupdate xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="desura" version="1">
 	<status code="0"/>
	<curropt /> 
</crashupdate>

107: Validation Error

<?xml version="1.0" encoding="utf-8"?> 
<crashupdate xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="desura" version="1">
 	<status code="107">The report field is required.</status>
	<validation>
		<fields>
			<report>The report field is required.</report> 
		</fields>
	</validation>
</crashupdate>

108: Permission Error

<?xml version="1.0" encoding="utf-8"?> 
<crashupdate xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="desura" version="1">
	<status code="108">We&#39;re sorry but you do not have permission to view the app content requested.</status>
</crashupdate>

100: Generic Error

<?xml version="1.0" encoding="utf-8"?> 
<crashupdate xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="desura" version="1">
	<status code="100">The app crash requested (http://www.desura.com/api/crashupdate) could not be found.</status>
</crashupdate>

Method

See: [wiki:GeneralCrashDumpProcessing]