ข้อมูลรับ (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>
    <rain24h>ฝน 1 วัน</rain24h>
    <rain48h>ฝน 2 วัน</rain48h>
    <rain72h>ฝน 3 วัน</rain72h>
    <rain96h>ฝน 4 วัน</rain96h>
    <rain120h>ฝน 5 วัน</rain120h>
    <rain144h>ฝน 6 วัน</rain144h>
    <rain168h>ฝน 7 วัน</rain168h>
  </station>
</ews>

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

{
  "title": "หัวข้อ",
  "numstation": "จำนวนสถานี",
  "date": "วันที่ของข้อมูล",
  "department": "หน่วยงาน",
  "station": [
    {
      "order": "ลำดับที่",
      "id": "รหัสสถานี",
      "village": "หมู่บ้าน",
      "subdistrict": "ตำบล",
      "district": "อำเภอ",
      "province": "จังหวัด",
      "rain": "ฝนราย 15 นาที",
      "rain12h": "ฝนราย 12 ชม.",
      "rain24h": "ฝน 1 วัน",
      "rain48h": "ฝน 2 วัน",
      "rain72h": "ฝน 3 วัน",
      "rain96h": "ฝน 4 วัน",
      "rain120h": "ฝน 5 วัน",
      "rain144h": "ฝน 6 วัน",
      "rain168h": "ฝน 7 วัน"
    }
  ]
}

ข้อผิดพลาด (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-weekly

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