Tarad API

          • Search
          • Store front
          • Error conditions
          • Limit rate

Search API

URL: http://API.tarad.com/search/

Formats: XML, JSON

HTTP Method: GET

Description: แสดงข้อมูลผ่านระบบ search ของ Tarad.com

Parameters:

 q – คำหลักที่ใช้ในการค้นหา (required)
 l – จำนวนข้อมูลสูงสุดที่ต้องการให้แสดง (optional, มาตราฐาน: 50)
 cat – รหัสหมวดมู่สินค้า (optional, มาตราฐาน: ทั้งหมด)
 offset – ตำแหน่งเริ่มต้น ของผลการค้นหา (optional, มาตราฐาน: 0=ตำแหน่งข้อมูลแรก)
 orderby - กำหนดให้เรียงผลการค้นหาตาม วันที่=date ราคา=price (optional)
 orderformat – กำหนดวิธีการเรียงข้อมูล desc,asc (optional, มาตราฐาน: desc)
 priceperiod – ช่วงของราคา รูปแบบ:ราคาตำสุด-ราคาสูงสุด (optional, default: ทั้งหมด)
 type – รูปแบบของข้อมูลที่ให้แสดง xml,json (optional, default: xml)

Notice:
 • <total_found> tag นี้จะคืนค่าผลการค้นหาทั้งหมด ซึ่งไม่ใช่ ค่า ของ ตัวแปร “l” ที่กำหนดไป

 • ในกรณีที่ ไม่พบข้อมูลที่ต้องการค้นหา API จะคืนค่า <respond> ออกมาเป็น No result
 ตัวอย่าง:
 <products>
 <respond>No result</respond>
 </products>

Response (truncated):
<products>
 <total_found>936</total_found>
 <product>
 <id>362919</id>
 <topic>Brain Box ชุด 1200</topic>
 <detail>
 ชุดการเรียนรู้เรื่องไฟฟ้าและอิเล็กทรอนิกส์ที่สมบูรณ์แบบที่สุด เรียนรู้จากวงจรต่างๆ มากกว่า 1200 วงจร ตั้งแต่ระดับพื้นฐานแบบง่ายๆ จนถึงวงจรที่ซับซ้อนขั้นสูง เพื่อเตรียมตัวเป็นนักประดิษฐ์อิเล็กทรอนิกส์ตัวจริง
 </detail>
 <pic>http://multi-toy.tarad.com/img-lib/spd_20080114162623.jpg</pic>
 <url>http://multi-toy.tarad.com/product.detail.php?id=1394152</url>
 <shopname>มัลติ เอดูเคชั่น</shopname>
 <category>อื่นๆ</category>
 <pricebaht>3300</pricebaht>
 <postdate>Mon, 14 Jan 2008 23:08:30 +0700</postdate>
 </product>
 <product>
 .
 .
 .
</products>

Store front API

URL: http://API.tarad.com/ store/

Formats: XML, JSON

HTTP Method: GET

Description: แสดงข้อมูลร้านค้า ของ Tarad.com

Parameters:
 shopurl – ชื่อ url ร้านค้า ตัวอย่างexample: “shopurl”->shopurl.tarad.com (required)
 l – จำนวนสินค้าสูงสุดที่ต้องการให้แสดง (optional, มาตราฐาน: 100)
 Type – รูปแบบของข้อมูลที่ให้แสดง xml,json (optional, default: xml)

Notice:
• ในกรณีที่ ร้านค้าดังกล่าวไม่มีสินค้า จะคืนค่า < products > ออกมาเป็น Empty product
ตัวอย่าง:
<products>
 <respond>Empty product</respond>
</products>

Response (truncated):
<store>
 <shop>
 <name>mother-sirotan</name>
 <url>http://mother-sirotan.tarad.com</url>
 <province>สงขลา</province>
 <zipcode>90110</zipcode>
 <geolat/>
 <geolong/>
 </shop>
<products>
 <product>
 <topic>SiRoTan สวมชุดคุณกระต่ายสีชมพูหางฟู</topic>
 <detail>
 ตุ๊กตาน้องแมวน้ำ SiRoTan สวมชุดคุณกระต่ายสีชมพูหางฟู ขนาด 17*60*25 cm. นุ่มนิ่มน่ารักมาก ๆ ค่ะ
 สามารถถอดชุดออกซักทำความสะอาดได้ค่ะ
 ……
 </detail>
 <category>อื่นๆ</category>
 <pricebaht>1600.00</pricebaht>
 <postdate>Mon, 04 Jan 2010 18:15:07 +0700</postdate>
 <url>http://mother-sirotan.tarad.com/product.detail_586573_th_2715936</url>
 <pic>http://mother-sirotan.tarad.com/shop/m/mother-sirotan/img-lib/spd_20100104181555.jpg</pic>
 </product>
 <product>
 .
 .
 .
</products>
</store>

Error conditions

หากไม่ได้ ใส่ parameter ที่กำหนดว่า จำเป็นต้องใส่ API จะคืนค่า error ออกมาเป็น Missing Attribute Value: parameter
ตัวอย่าง:
<products>
<error>Missing Attribute Value: q</error>
</products>

หากค่าใส่ค่า parameter ไม่ถูกรูปแบบ API จะคืนค่า error ออกมาเป็น Invalid Attribute Value: parameter
ตัวอย่าง:
<products>
<error>Invalid Attribute Value: l</error>
</products>

API Limit rate

api อณุญาติให้ผเรียกใช้ได้ 100 ครั้ง ต่อชั่วโมง ถ้าหากมีการเรียกใช้ api ถึงจำนวนที่กำหนดไว้ api จะคือค่า error ออกมาเป็น API Limit Exceeded
ตัวอย่าง:
<products>
<error>Invalid Attribute Value: l</error>
</products>

Premiummall shop list API

URL: http://API.tarad.com/premiumlist/

Formats: XML, JSON

HTTP Method: GET

Description: แสดงข้อมูลร้านค้า ของ Tarad.com

Parameters:
page–หน้าของจำนวนที่ใส่แสดง (จำนวนของ ร้านค้าที่แสดงต่อหน้า 100 ร้านค้า) (optional, มาตราฐาน: 100)
Response (truncated):

<shops>
 <pagging>
 <totalpage>10</totalpage>
 <totalitem>960</totalitem>
 <currentpage>1</currentpage>
 <item_per_page>100</item_per_page>
 </pagging>
 <shop id="179623">
 <name>ออร่าสกิน</name>
 <url>http://auraskins.tarad.com</url>
 </shop>
 <shop id="163922">
 <name>59shop</name>
 <url>http://59shop.tarad.com</url>
 </shop>
 <shop id="123047">
 <name>ดอกไม้ครอสติช</name>
 <url>http://dmcrossstitch.tarad.com</url>
 </shop>
 <shop id="4166">
 <name>Bangkok Watch Corner Co,Ltd.</name>
 <url>http://dreamu.tarad.com</url>
 </shop>
 <shop id="6321">
 <name>MediA</name>
 <url>http://mediatech.tarad.com</url>
 </shop>
 <shop id="204001">
 <name>ร้านภูตะวันเสื้อสวย</name>
 <url>http://phutawanja.tarad.com</url>
 </shop>
 <shop id="204915">
 <name>ชื่อร้าน</name>
 <url>http://naturetouch-missrose.tarad.com</url>
 </shop>
<shops>