API Return Template

API Return Template

The API will return in JSON format. Every return JSON should include the following 4 entries.

• uid: The unique id of target user
• object: Object type of target object, which is same as api path
• action: Action to the target object, which is same as api path
• brea: Status code, 0 is correct.
• server_time: Server time with UTC+8.

An alternative payload is sent back if there's some query information.

• payload: The return information of target object

In some read api, if not designate id, it will return a list of items.

Payload foramt

There are always 2 entries in payload.

• type: Type of payload, either Attribute Name or Objects
• attribute name: Value of corresponding attribute name, where attribute name can be status, mid, tid etc. Only exists when type be Attribute Name.
• Objects: Whole objects attributes key/value pair.

Examples

No payload return

Return JSON of /api/v1/member/callhelp

{ 
  "uid": 86,
  "object": "member",
  "action": "callhelp",
  "brea": 0,
  "server_time": "2017-04-01T14:38:29.765Z"
}

Single value payload return

Return JSON of /api/v1/report/create

{ 
  "uid": 34,
  "object": "report",
  "action": "create",
  "brea": 0,
  "server_time": "2017-04-01T14:38:29.765Z",
  "payload":{
        "type": "Attribute Name",
        "rid": 16
  }
}

Object payload return

Return JSON of /api/v1/mission/read(requesting mid 12)

{ 
  "uid": 34,
  "object": "report",
  "action": "create",
  "brea": 0,
  "server_time": "2017-04-01T15:24:59.987Z",
  "payload":{
        "type": "Objects",
        "objects": [
                        {
                            "mid": 12,
                            "title": "證人救出",
                            "content": "證人Jacky快要被黑暗組織逮捕啦!! 快去湖心亭將Jacky帶回總部 blah blah blah",
                            "time_start": "14:03",
                            "time_end": "14:23",
                            "price": 1500,
                            "clue": 8,
                            "class": "MAIN",
                            "score": 20,
                            "location_e": 120.995106,
                            "location_n": 24.794090
                        }
        ]
  }     
}

Object list payload return

Return JSON of /api/v1/mission/read (No designate mid

{ 
  "uid": 34,
  "object": "report",
  "action": "create",
  "brea": 0,
  "server_time": "2017-04-01T15:24:59.987Z",
  "payload":{
        "type": "Objects",
        "objects": [
                        {
                            "mid": 12,
                            "title": "證人救出",
                            "content": "證人Jacky快要被黑暗組織逮捕啦!! 快去湖心亭將Jacky帶回總部 blah blah blah",
                            "time_start": "14:03",
                            "time_end": "14:23",
                            "price": 1500,
                            "clue": 8,
                            "class": "MAIN",
                            "score": 20,
                            "location_e": 120.995106,
                            "location_n": 24.794090
                        },
                        {
                            "mid": 15,
                            "title": "抓住證人",
                            "content": "證人Jacky發瘋了! 找到他將他制伏",
                            "time_start": "14:15",
                            "time_end": "14:30",
                            "price": 1100,
                            "clue": 10,
                            "class": "SUB",
                            "score": 10,
                            "location_e": 0,
                            "location_n": 0
                        }
        ]
  }
}

Contact information return

Return JSON of /utility/0

{
  "status": 0,
  "object": [
    {
      "team": 1,
      "name": "No name",
      "nickname": "No nickname",
      "phone": "0900000000"
    },
    {
      "team": 2,
      "name": "Hi",
      "nickname": "Blablabla",
      "phone": "0911111111"
    }
  ]
}

• status is for returning status recognition. 0 for success and >0 for error.
• name for squad leader's real name and nickname for nickname.
• team for squad id. The possible id will be 1~12.
• phone for the leader's cell phone number without dash -