สเปกฟีดทรัพย์สำหรับ Propal
เอกสารสำหรับผู้ดูแลเว็บไซต์ ใช้สร้างไฟล์ RSS ให้ Propal ดึงรายการทรัพย์และรูปภาพเข้าบัญชีของนายหน้า
1. ทำไฟล์ RSS
เว็บไซต์สร้างไฟล์ RSS 2.0 ตามตัวอย่างด้านล่าง เพิ่ม field ของ Propal ด้วย
propal:2. เปิดลิงก์สาธารณะ
ไฟล์ต้องเปิดได้โดยไม่ต้องล็อกอิน เช่น
https://your-site.com/feed.xml3. ส่งลิงก์ให้นายหน้า
นายหน้าวางลิงก์ใน Propal ระบบแสดงตัวอย่างให้ตรวจก่อนนำเข้า
ทรัพย์ที่นำเข้าจะเป็น ฉบับร่าง ให้นายหน้าตรวจก่อนเผยแพร่ ฟีด RSS/Atom ธรรมดา (ชื่อ คำบรรยาย ลิงก์ รูป) ก็นำเข้าได้ แต่ราคา ประเภท ห้องนอน ฯลฯ ต้องมี field
propal: ถึงจะอ่านได้แม่นยำข้อกำหนดของลิงก์
| หัวข้อ | ค่า |
|---|---|
| โปรโตคอล | https:// (หรือ http://) พอร์ตมาตรฐาน 80/443 เท่านั้น |
| การเข้าถึง | เปิดได้โดยไม่ต้องล็อกอิน (ลิงก์ที่ฝัง user:password ไม่รองรับ) |
| ขนาดไฟล์ | ไม่เกิน 5 MB |
| จำนวนรายการต่อครั้ง | ไม่เกิน 200 รายการ (เกินจะตัดทิ้ง) |
| Content-Type | application/rss+xml, application/xml หรือ text/xml |
| การเข้ารหัส | UTF-8 ไม่ต้อง gzip |
| ห้ามมี | <!DOCTYPE> และ <!ENTITY> (ระบบปฏิเสธเพื่อความปลอดภัย) |
โครงสร้างแต่ละรายการ (<item>)
<guid>รหัสทรัพย์ในเว็บของคุณ ต้องคงที่ตลอด<title>ชื่อทรัพย์ (บังคับ)<link>ลิงก์หน้าประกาศบนเว็บของคุณ<description>คำบรรยาย (HTML จะถูกตัดแท็กเหลือข้อความล้วน)<propal:updated>เวลาแก้ไขล่าสุด รูปแบบ ISO 8601 (เตรียมไว้สำหรับซิงก์อัตโนมัติในอนาคต)
รูปภาพ (สูงสุด 20 รูปต่อทรัพย์)
ใส่ได้ 3 แบบ เลือกแบบเดียวก็พอ รูปแรกคือรูปปก
<media:content url="..." medium="image"/><enclosure url="..." type="image/jpeg"/><propal:image>URL</propal:image>(ใส่ซ้ำได้หลายรูป)
ลิงก์รูปต้องเปิดได้สาธารณะ ไม่ต้องล็อกอิน และไม่บล็อกการเรียกจากเว็บไซต์อื่น ชนิด JPG / PNG / WebP ขนาดไม่เกิน 10 MB ต่อรูป ระบบจะดาวน์โหลด ย่อ (ด้านยาวสุด 1600 px) แปลงเป็น WebP และตัดข้อมูล EXIF/พิกัดออก แล้วเก็บสำเนาไว้ในบัญชีของนายหน้า
Field ของ Propal
ใส่เป็น tag propal:ชื่อ ใน <item> field ที่ไม่มีข้อมูลไม่ต้องใส่
| Tag | ความหมาย | ชนิด | บังคับ | ค่าที่รับ / หมายเหตุ | ตัวอย่าง |
|---|---|---|---|---|---|
propal:title | ชื่อทรัพย์ | ข้อความ | บังคับ | ใช้ <title> ของ RSS แทนได้ · ไม่เกิน 200 ตัวอักษร | คอนโด ลุมพินี สุขุมวิท 24 |
propal:propertyType | ประเภททรัพย์ | ค่าที่กำหนด | บังคับ | CONDO, HOUSE, TOWNHOUSE, LAND, COMMERCIAL, APARTMENT, RESORT, POOL_VILLA, WAREHOUSE | CONDO |
propal:listingType | ประเภทประกาศ | ค่าที่กำหนด | บังคับ | SALE (ขาย), RENT (เช่า), BOTH (ขายและเช่า), INSTALLMENT (ผ่อนตรงกับเจ้าของ) | SALE |
propal:price | ราคาขาย (บาท) | ตัวเลข | ตามประเภทประกาศ | บังคับเมื่อ SALE หรือ BOTH · ตัวเลขล้วน | 3500000 |
propal:rentalPriceMonthly | ราคาเช่าต่อเดือน (บาท) | ตัวเลข | ตามประเภทประกาศ | บังคับเมื่อ RENT หรือ BOTH · ตัวเลขล้วน | 25000 |
propal:province | จังหวัด | ข้อความ | ไม่บังคับ | กรุงเทพมหานคร | |
propal:district | อำเภอ/เขต | ข้อความ | ไม่บังคับ | วัฒนา | |
propal:subdistrict | ตำบล/แขวง | ข้อความ | ไม่บังคับ | คลองตันเหนือ | |
propal:postalCode | รหัสไปรษณีย์ | ข้อความ | ไม่บังคับ | ตัวเลข 5 หลัก | 10110 |
propal:address | ที่อยู่ | ข้อความ | ไม่บังคับ | ไม่เกิน 500 ตัวอักษร | 123/45 ถ.สุขุมวิท 24 |
propal:areaSqm | พื้นที่ใช้สอย (ตร.ม.) | ตัวเลข | ไม่บังคับ | 45 | |
propal:landRai | เนื้อที่ (ไร่) | ตัวเลข | ไม่บังคับ | 1 | |
propal:landNgan | เนื้อที่ (งาน) | ตัวเลข | ไม่บังคับ | 2 | |
propal:landSqwa | เนื้อที่ (ตร.วา) | ตัวเลข | ไม่บังคับ | 50 | |
propal:bedrooms | ห้องนอน | จำนวนเต็ม | ไม่บังคับ | 2 | |
propal:bathrooms | ห้องน้ำ | จำนวนเต็ม | ไม่บังคับ | 2 | |
propal:floors | จำนวนชั้น | จำนวนเต็ม | ไม่บังคับ | 5 | |
propal:parkingSpaces | ที่จอดรถ | จำนวนเต็ม | ไม่บังคับ | 1 | |
propal:securityDeposit | เงินประกัน (บาท) | ตัวเลข | ไม่บังคับ | ใช้เฉพาะประกาศเช่า | 50000 |
propal:latitude | ละติจูด | ตัวเลข | ไม่บังคับ | -90 ถึง 90 | 13.7305 |
propal:longitude | ลองจิจูด | ตัวเลข | ไม่บังคับ | -180 ถึง 180 | 100.5695 |
propal:locationUrl | ลิงก์แผนที่ | ข้อความ | ไม่บังคับ | ขึ้นต้นด้วย http(s):// หรือพิกัด "lat, lng" | https://maps.google.com/... |
propal:videoUrl | ลิงก์วิดีโอ | ข้อความ | ไม่บังคับ | ขึ้นต้นด้วย http(s):// | https://youtube.com/... |
propal:virtualTourUrl | ลิงก์ Virtual Tour | ข้อความ | ไม่บังคับ | ขึ้นต้นด้วย http(s):// | https://... |
propal:websiteUrl | ลิงก์หน้าประกาศ | ข้อความ | ไม่บังคับ | ลิงก์หน้าประกาศบนเว็บคุณ · ถ้าไม่ใส่จะใช้ <link> แทน | https://... |
propal:hasFurniture | มีเฟอร์นิเจอร์ | true/false | ไม่บังคับ | true หรือ false | true |
propal:petsAllowed | สัตว์เลี้ยงที่อนุญาต | หลายค่า | ไม่บังคับ | DOG, CAT คั่นด้วย | เช่น DOG|CAT | แมว|สุนัขเล็ก |
propal:poolLengthM | สระ ยาว (ม.) | ตัวเลข | ไม่บังคับ | เฉพาะ POOL_VILLA | 8 |
propal:poolWidthM | สระ กว้าง (ม.) | ตัวเลข | ไม่บังคับ | เฉพาะ POOL_VILLA | 4 |
propal:poolDepthM | สระ ลึก (ม.) | ตัวเลข | ไม่บังคับ | เฉพาะ POOL_VILLA | 1.4 |
propal:poolType | ประเภทสระ | ข้อความ | ไม่บังคับ | INFINITY | |
propal:poolSystem | ระบบสระ | ข้อความ | ไม่บังคับ | SALTWATER | |
propal:description | คำบรรยาย | ข้อความ | ไม่บังคับ | ใช้ <description> ของ RSS แทนได้ · ไม่เกิน 3,000 ตัวอักษร | วิวสวย ใกล้ BTS อโศก |
propal:titleEn | ชื่อทรัพย์ภาษาอังกฤษ | ข้อความ | ไม่บังคับ | Lumpini Suite Sukhumvit 24 Condo | |
propal:titleZh | ชื่อทรัพย์ภาษาจีน | ข้อความ | ไม่บังคับ | 素坤逸24公寓 | |
propal:descriptionEn | คำบรรยายภาษาอังกฤษ | ข้อความ | ไม่บังคับ | Nice view, near BTS Asoke | |
propal:descriptionZh | คำบรรยายภาษาจีน | ข้อความ | ไม่บังคับ | 风景优美，靠近BTS | |
propal:downPayment | เงินดาวน์ (บาท) | ตัวเลข | ไม่บังคับ | เฉพาะ INSTALLMENT | 200000 |
propal:monthlyInstallment | ค่างวดต่อเดือน (บาท) | ตัวเลข | ตามประเภทประกาศ | บังคับเมื่อ INSTALLMENT | 15000 |
propal:installmentMonths | ระยะผ่อน (เดือน) | จำนวนเต็ม | ตามประเภทประกาศ | บังคับเมื่อ INSTALLMENT · 1–600 | 120 |
propal:installmentInterestPct | ดอกเบี้ยผ่อน (% ต่อปี) | ตัวเลข | ไม่บังคับ | 0–100 (% ต่อปี) | 0 |
propal:commonFeeMonthly | ค่าส่วนกลางต่อเดือน (บาท) | ตัวเลข | ไม่บังคับ | 1500 |
กฎการกรอก
- ตัวเลข ตัวเลขล้วน ไม่มี comma หน่วย หรือสัญลักษณ์ เช่น
3500000 - ค่าที่กำหนด ใช้รหัสภาษาอังกฤษตามตาราง (ตัวพิมพ์ใหญ่)
- true/false ใช้
trueหรือfalse - ไม่รับจากฟีด ข้อมูลโฉนด ราคาประเมิน หมายเหตุภายใน และสถานะ ระบบละเว้นแม้ใส่มา
- รายการที่ข้อมูลไม่ผ่านเงื่อนไข ระบบแจ้งสาเหตุในหน้าตัวอย่างและข้ามรายการนั้น ไม่กระทบรายการอื่น ชื่อทรัพย์ที่ซ้ำกับของที่มีในบัญชีแล้วจะถูกข้ามเช่นกัน
ตัวอย่างไฟล์
<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0"
xmlns:propal="https://propal.app/ns/feed/1"
xmlns:media="http://search.yahoo.com/mrss/">
<channel>
<title>ทรัพย์ของ บริษัท ตัวอย่างพร็อพเพอร์ตี้</title>
<link>https://example.com</link>
<description>รายการทรัพย์ขาย-เช่า</description>
<propal:version>1</propal:version>
<!-- ตัวอย่างที่ 1: คอนโดขาย -->
<item>
<guid isPermaLink="false">EX-1024</guid>
<title>คอนโด ลุมพินี สุขุมวิท 24 ห้องมุม วิวสวน</title>
<link>https://example.com/property/1024</link>
<description><![CDATA[<p>ห้องมุม ชั้น 15 วิวสวน ใกล้ BTS พร้อมพงษ์</p>]]></description>
<propal:updated>2026-10-17T09:00:00+07:00</propal:updated>
<propal:propertyType>CONDO</propal:propertyType>
<propal:listingType>SALE</propal:listingType>
<propal:price>3500000</propal:price>
<propal:areaSqm>45</propal:areaSqm>
<propal:bedrooms>1</propal:bedrooms>
<propal:bathrooms>1</propal:bathrooms>
<propal:province>กรุงเทพมหานคร</propal:province>
<propal:district>คลองเตย</propal:district>
<propal:postalCode>10110</propal:postalCode>
<propal:hasFurniture>true</propal:hasFurniture>
<media:content url="https://example.com/img/1024-1.jpg" medium="image"/>
<media:content url="https://example.com/img/1024-2.jpg" medium="image"/>
</item>
<!-- ตัวอย่างที่ 2: บ้านให้เช่า (ใช้ enclosure สำหรับรูป) -->
<item>
<guid isPermaLink="false">EX-2048</guid>
<title>บ้านเดี่ยว 2 ชั้น หมู่บ้านตัวอย่าง ให้เช่า</title>
<link>https://example.com/property/2048</link>
<description>บ้านเดี่ยว 3 ห้องนอน เลี้ยงสัตว์ได้</description>
<propal:propertyType>HOUSE</propal:propertyType>
<propal:listingType>RENT</propal:listingType>
<propal:rentalPriceMonthly>35000</propal:rentalPriceMonthly>
<propal:bedrooms>3</propal:bedrooms>
<propal:bathrooms>3</propal:bathrooms>
<propal:petsAllowed>DOG|CAT</propal:petsAllowed>
<propal:province>นนทบุรี</propal:province>
<enclosure url="https://example.com/img/2048-1.jpg" type="image/jpeg" length="0"/>
</item>
</channel>
</rss>
ต้องการนำเข้าทรัพย์จากเว็บไซต์ของคุณ?
สมัครใช้ Propal แล้วไปที่ ตั้งค่า → นำเข้า/ส่งออก → ลิงก์ RSS / XML
สเปกฟีดเวอร์ชัน 1 · field ใหม่อาจเพิ่มได้โดยไม่เปลี่ยนเวอร์ชัน ส่วนการเปลี่ยนความหมายของ field เดิมจะขึ้นเวอร์ชันใหม่