ข้อมูลรับ (Input)

• รหัสผู้ใช้ (uid)
• รหัสผ่าน (upass)
• รูปแบบข้อมูล (dtype)
  • dtype = 1 รูปแบบข้อมูล XML
  • dtype = 2 รูปแบบข้อมูล JSON
• สถานะฝน (status)
  • status = 3 อพยพ
  • status = 2 เตือนภัย
  • status = 1 เฝ้าระวัง
  • status = 9 มีฝน
  • status = 0 ไม่มีฝน
  • status = -999 เชื่อมต่อสัญญาณ

ข้อมูลส่งกลับ (Output)

รูปแบบข้อมูล XML

<ews>
  <title>หัวข้อ</title>
  <numstation>จำนวนสถานี</numstation>
  <date>วันที่ของข้อมูล</date>
  <department>หน่วยงาน</department>
  <station id="รหัสสถานี" order="ลำดับที่">
    <village>หมู่บ้าน</village>
    <subdistrict>ตำบล</subdistrict>
    <district>อำเภอ</district>
    <province>จังหวัด</province>
    <rain>ฝนราย 15 นาที</rain>
    <rain12h>ฝนราย 12 ชม.</rain12h>
    <rainday01>ฝนวันที่01</rainday01>
    <rainday02>ฝนวันที่02</rainday02>
    <!-- เพิ่มไปจนถึงวันที่ 30 -->
    <rainday30>ฝนวันที่30</rainday30>
  </station>
</ews>

รูปแบบข้อมูล JSON

{
  "title": "หัวข้อ",
  "numstation": "จำนวนสถานี",
  "date": "วันที่ของข้อมูล",
  "department": "หน่วยงาน",
  "station": [
    {
      "order": "ลำดับที่",
      "id": "รหัสสถานี",
      "village": "หมู่บ้าน",
      "subdistrict": "ตำบล",
      "district": "อำเภอ",
      "province": "จังหวัด",
      "rain": "ฝนราย 15 นาที",
      "rain12h": "ฝนราย 12 ชม.",
      "rainday01": "ฝนวันที่ 01",
      "rainday02": "ฝนวันที่ 02",
      // เพิ่มไปจนถึงวันที่ 30
      "rainday30": "ฝนวันที่ 30"
    }
  ]
}

ข้อผิดพลาด (Error Handling)

ถ้าข้อมูลรับ (input) ไม่ถูกต้อง จะได้ข้อมูลส่งกลับ (output) ดังนี้

กรณีรหัสผู้ใช้ หรือรหัสผ่านไม่ถูกต้อง หรือไม่อยู่ในระบบ Webservice

• รูปแบบข้อมูล XML: <error>รหัสผู้ใช้ หรือรหัสผ่านไม่ถูกต้อง</error>
• รูปแบบข้อมูล JSON: {"error": "รหัสผู้ใช้ หรือรหัสผ่านไม่ถูกต้อง"}

กรณีระดับผู้ใช้ไม่ใช่ admin

• รูปแบบข้อมูล XML: <error>ระดับผู้ใช้ต้องเป็น Admin เท่านั้น</error>
• รูปแบบข้อมูล JSON: {"error": "ระดับผู้ใช้ต้องเป็น Admin เท่านั้น"}

ตัวอย่างการใช้งาน

URL หลัก = http://202.129.59.84/ews/web-service/rain-monthly

ตัวอย่าง URL พร้อมพารามิเตอร์