คำขอและการตอบกลับ

หน้านี้อธิบายรูปแบบเนื้อหาคำขอ โครงสร้างการตอบกลับ การแบ่งหน้า รูปแบบวันที่และจำนวนเงิน รวมถึงวิธีตีความรหัสสถานะ HTTP

เนื้อหาคำขอ#

เอนด์พอยต์ใช้รูปแบบเนื้อหาอย่างใดอย่างหนึ่งจากสองรูปแบบ หน้าเอกสารอ้างอิงของแต่ละเอนด์พอยต์จะระบุว่าใช้แบบใด

ฟิลด์แบบอาร์เรย์ในเนื้อหาแบบฟอร์มจะส่งซ้ำโดยใช้วงเล็บเหลี่ยม: childAges[]=7&childAges[]=12 เนื้อหาแบบ JSON ต้องเข้ารหัสเป็น UTF-8

โครงสร้างการตอบกลับ#

การตอบกลับเป็น JSON ส่วนใหญ่มีแฟล็ก success และรายการต่าง ๆ จะส่งกลับมาพร้อม count และ items:

{
    "success": true,
    "count": 3,
    "items": [
        {
            "id": 1,
            "titleCode": "TRY",
            "symbol": "₺",
            "price": 1
        },
        {
            "id": 2,
            "titleCode": "EUR",
            "symbol": "€",
            "price": 47.85000000000000142108547152020037174224853515625
        }
    ]
}

เมื่อไม่ผ่านการตรวจสอบตามกฎทางธุรกิจ จะส่งคืน success: false พร้อมคำอธิบายข้อผิดพลาดในรูปแบบใดรูปแบบหนึ่งจากสองรูปแบบนี้:

{
    "success": false,
    "message": "online_cupon_is_not_found"
}

{
    "success": false,
    "errorMessage": "Invalid parameters.",
    "errorCode": 10022
}

ข้อยกเว้น: เอนด์พอยต์ข้อมูลติดต่อส่งคืนออบเจ็กต์เปล่าโดยไม่มีโครงสร้างครอบ และการส่งการจองส่งคืนออบเจ็กต์ BookingPushRS ทั้งสองกรณีแสดงไว้ในเอกสารอ้างอิง

รหัสสถานะ HTTP#

การแบ่งหน้า#

เอนด์พอยต์แบบรายการ (/external/currencies, /external/languages, /external/online/social/media, /external/stock/packages) แบ่งหน้าตามหมายเลขหน้า:

count คือจำนวนรายการทั้งหมด รายการจะหมดเมื่อ page × limit ≥ count

วันที่ เวลา และจำนวนเงิน#

วันเช็กเอาต์ไม่นับเป็นส่วนหนึ่งของการเข้าพัก: 18–20 สิงหาคม คือสองคืน อย่าบวกจำนวนเงินด้วย float ให้ใช้ไลบรารีทศนิยมหรือจำนวนเต็มในหน่วยย่อยของสกุลเงินแทน

ภาษา#

รายการห้องพักรับฟิลด์ language (ISO 639-1: tr, en, de…) และส่งคืนชื่อห้อง ชื่อสิ่งอำนวยความสะดวก และข้อความแสดงข้อผิดพลาดในภาษานั้น ส่วนรายการแพ็กเกจต้องการ languageID ซึ่งได้จากเอนด์พอยต์ภาษา