Web Services

ระบบล็อคอินผ่าน Web Service

คำอธิบาย : ฟังก์ชัน login เืพื่อสามารถใ้ช้งานฟังก์ชันอื่นๆของระบบได้

URL :

http://bookmark.jersure.com/webservices/authenicate/$username/$password

โดย $username ให้ใส่ username ส่วน $password ให้ใส่ password ตัวอย่างเช่น

http://bookmark.jersure.com/webservices/authenicate/abcde/12345

Method : GET

Format : XML

ตัวอย่างรูปแบบการตอบสนอง

เมื่อ Password ถูก


	<array>
	<message>Login Successful</message>
	</array>

เมื่อ Password ผิด


	<array>
	<message>Username or Password is wrong</message>
	</array>

บันทึกบุคมาร์ค

คำอธิบาย : บันทึกบุกมาร์คลง user ที่เข้าสู่ระบบ ณ ตอนนี้โดย
มีเงื่อนไขคือจะต้องล็อคอินผ่านเว็บหรือระบบล็อคอินผ่าน Web Service

URL :

http://bookmark.jersure.com/webservices/save_bookmark/?url={$url}&title={$title}&description={$description}

โดย {$url} คือ URL ที่ต้องการ {$title} คือหัวข้อ {$description} คือคำอธิบาย เช่น

http://bookmark.jersure.com/webservices/save_bookmark/?url=http://www.thaiware.com&title=Thaiware&description=thaiware

Method : GET

Format : XML

ตัวอย่างรูปแบบการตอบสนอง

เมื่อสามารถบันทึกบุคมาร์คได้


	
	<array>
<message>Save Complete</message>
</array>

เมื่อไม่สามารถบันทึกบุคมาร์คได้


	
	<array>
	<n0>
	<p>Your already have this Url bookmark</p>
	</n0>
	</array>

สุ่มจากบุคมาร์คทั้งหมด

คำอธิบาย : สุ่มบุคมาร์คหนึ่งอันจากบุคมาร์คทั้งหมด

URL :

http://bookmark.jersure.com/webservices/get_random_bookmark/

Method : GET

Format : XML

ตัวอย่างรูปแบบการตอบสนอง

เมื่อส่งค่ากลับมา


	<array>
	<id>18</id>
	<url>http://master.com</url>
	<title>Master</title>
	<description>Hello</description>
	</array>

สุ่มบุคมาร์คจากแท็ก

คำอธิบาย : สุ่มบุคมาร์คหนึ่งอันจากบุคมาร์คทั้งหมดที่มีใน tag ที่ค้นหา

URL :

http://bookmark.jersure.com/webservices/get_random_bookmark_by_tag/{$tag}

โดย {$tag} คือ tag ที่ต้องการค้นหา เช่น

http://bookmark.jersure.com/webservices/get_random_bookmark_by_tag/hello

Method : GET

Format : XML

ตัวอย่างรูปแบบการตอบสนอง

เมื่อส่งค่ากลับมา


	<array>
	<id>18</id>
	<url>http://master.com</url>
	<title>Master</title>
	<description>Hello</description>
	</array>

	
	<array>
	<id>36</id>
	<url>http://www.testing.com</url>
	<title>Testing</title>
	<description>Yes</description>
	</array>

สุ่มบุคมาร์คจากชื่อผู้ใช้งาน

คำอธิบาย : สุ่มบุคมาร์คหนึ่งอันจากบุคมาร์คทั้งหมดจากชื่อผู้ใช้งานที่ค้นหา

http://bookmark.jersure.com/webservices/get_random_bookmark_by_user/{$user}

{$user} คือชื่อ username ตัวอย่างเช่น

http://bookmark.jersure.com/webservices/get_random_bookmark_by_user/abcde

Method : GET

Format : XML

ตัวอย่างรูปแบบการตอบสนอง

เมื่อส่งค่ากลับมา


	<array>
	<id>18</id>
	<url>http://master.com</url>
	<title>Master</title>
	<description>Hello</description>
	</array>

	
	<array>
	<id>36</id>
	<url>http://www.testing.com</url>
	<title>Testing</title>
	<description>Yes</description>
	</array>

แสดงบุคมาร์คที่ได้รับความนิยมตลอดกาล

คำอธิบาย : แสดงผลบุคมาร์คที่ติดอันดับความนิยมตลอดกาลตามจำนวนที่กำหนด

URL :

http://bookmark.jersure.com/webservices/get_top_bookmarks/{$number}/{$offset=0}

โดย {$number} คือจำนวนที่ต้องการให้แสดง เช่น 10 ส่วน {$offset} นั้นปกติจะมีค่าเป็น 0 ตัวแปรนี้จะเป็นการชดเชยผลลัพธ์ เช่น ถ้า {$number} เป็น 10 {$offset} เป็น 10 หมายความว่า แสดงผลอันดับที่ 11-20 เพราะแสดง 10 แล้วให้ชดเชยไป 10 อันดับ นั้นคือเราไม่เอา 10 อันดับแรก ตัวอย่างการใช้งาน

http://bookmark.jersure.com/webservices/get_top_bookmarks/10/0

Method : GET

Format : XML

ตัวอย่างรูปแบบการตอบสนอง

เมื่อส่งค่ากลับมา


	<result>

	<top_bookmark> 
			<id>9</id> 
			<title>ClipMass</title> 
			<url>http://clipmass.com</url> 
			<description> 
				http://clipmass.com
			</description> 
		</top_bookmark>
	

	
	<top_bookmark> 
		<id>23</id> 
		<title>E.ggTimer: Dead-Easy Countdown Timer</title> 
		<url>http://www.makeuseof.com/dir/eggtimer/</url> 
		<description> 
			http://www.makeuseof.com/dir/eggtimer/
		</description> 
	</top_bookmark>

	</result>

แสดงบุคมาร์คที่ได้รับความนิยมในช่วง 30 วันที่ผ่านมา

คำอธิบาย : แสดงผลบุคมาร์คที่ติดอันดับความนิยมใน 30 วันที่ผ่านมาตามจำนวนผลลัพธ์ที่กำหนด

URL :

http://bookmark.jersure.com/webservices/get_top_recent_bookmarks/{$number}/{$offset=0}

http://bookmark.jersure.com/webservices/get_top_recent_bookmarks/10/0

Method : GET

Format : XML

ตัวอย่างรูปแบบการตอบสนอง

เมื่อส่งค่ากลับมา


	<result>

	<top_bookmark> 
			<id>9</id> 
			<title>ClipMass</title> 
			<url>http://clipmass.com</url> 
			<description> 
				http://clipmass.com
			</description> 
		</top_bookmark>
	

	
	<top_bookmark> 
		<id>23</id> 
		<title>E.ggTimer: Dead-Easy Countdown Timer</title> 
		<url>http://www.makeuseof.com/dir/eggtimer/</url> 
		<description> 
			http://www.makeuseof.com/dir/eggtimer/
		</description> 
	</top_bookmark>

	</result>