CampusSearch XML interface

Het is mogelijk om CampusSearch database te raadplegen via een GET-request, waarmee je een XML output kan genereren. Dit is de eerste versie van het geheel en zal zeker in de toekomst nog aangepast worden.

Als je gebruik maakt van dit interface, zet je project bij Projecten die gebruikt maken van het XML interface.

Voor verdere vragen of uitbreidingen, neem contact op met ddofborg.

GET parameters

Doe een GET request naar http://search.student.utwente.nl/api/search.

Deze parameters worden ondersteund (de waarden van de GET-parameters moeten URL-encoded zijn):

• q: de zoek string, bijv. "The+Matrix" (verplicht).
• page: paginanummer, elke 'pagina' heeft 30 resultaten, beginnend bij 0 (0-29), dan 1 (30-59), etc.
• minsize: minimale grootte van de file/dir, bijv. 0.5M of 1G.
• maxsize: maximale grootte van de file/dir, bijv. 0.5M of 1G.
• dirsonly waarde 'yes' als je alleen op directories wilt zoeken.

Voorbeeld van XML uitvoer

Voorbeeld, zoeken naar directories genaamd "The Matrix", met minimale grootte 0.5G en maximale grootte 2G:

http://search.student.utwente.nl/api/search?q=the+matrix&page=0&minsize=0.5G&maxsize=2G&dirsonly=yes

Een deel van de XML die uit komt is als volgt:

<campus_search> 
	<result> 
		<rank>9</rank> 
		<netbios_name>NZSERVER</netbios_name> 
		<ip>130.89.162.28</ip> 
		<type>file</type> 
		<full_path>smb://130.89.162.28/Movies/IMDB top 30/30 - The Matrix/The Matrix [1].avi</full_path> 
		<dir>Movies/IMDB top 30/30 - The Matrix</dir> 
		<name>The Matrix [1].avi</name> 
		<online>no</online> 
		<size>735412224</size> 
		<meta> 
			<imdb_url>http://imdb.com/title/tt0133093</imdb_url> 
			<imdb_rating>8.7</imdb_rating> 
			<imdb_year>1999</imdb_year> 
		</meta> 
	</result> 
</campus_search> 

Foutmeldingen

Een foutmelding ziet er als volgt uit:

<campus_search> 
	<result> 
		<status>error</status> 
		<error_code>ERROR_SEARCH_NO_RESULTS</error_code> 
	</result> 
</campus_search> 

Element error_code kan een van de volgende waarden hebben: ERROR_SEARCH_NO_RESULTSof ERROR_SEARCH_INCORRECT_QUERY. Eerste geeft aan dat er geen resultaten gevonden zijn, de tweede dat de aanvraag niet volledig of incorrect was.

Projecten die gebruik maken van het XML interface

Zet ook even je naam/e-mail hieronder, dan kunnen mensen contact met je opnemen.

• Campusnet Music Player (source: http://muziek.student.utwente.nl/muziek/CampusSearch.phps)
  • De links doen het niet (05-10-2009)
• V-Direct is een nieuw leven in geblazen. Meer informatie volgt.
• Prometheus, de nieuwe campusnet client Prometheus http://code.google.com/p/campusnet-prometheus/downloads/list

Zie ook

• CampusSearch
• CampusSearch development

Externe links

• http://search.student.utwente.nl/