Kartu Laporan

Kartu laporan PetaBencana untuk kejadian bencana. Catatan: autentikasi diperlukan untuk membuat pembaruan pada kartu.

Format Permintaan

Parameter URL

Deskripsi

Format

Wajib

cardId

Pengenal unik dari kartu yang ingin kita gunakan, dihasilkan oleh sistem ketika kartu awal dibuat (wajib)

String (7 sampai 14 karakter)

Ya

Atribut

Deskripsi

Format

Wajib

card_data

Data pengguna yang dikumpulkan dalam antarmuka kartu

JSON

Ya

text

Deskripsi dari kejadian bencana

String

Tidak

image_id

Pengenal gambar kartu terkait

String

Tidak

created_at

Tanggal dan jam kartu dibuat

Ya

location

Lokasi geografis dari kejadian bencana

Ya

Catatan untuk card_data

Data kartu membutuhkan objek report_type untuk ada. Dimanadisaster_type diatur ke 'flood' dan objek flood_depth juga harus ada di sebelah report_type. Jika disaster_type adalah 'prep' maka report_type harus menjadi salah satu jenis seperti yang ditentukan di server config.js.

Misalnya kartu dengan data banjir termasuk flood_depth:

  "disaster_type": "flood",
  "card_data":{
    "report_type": "flood",
    "flood_depth": 50
  }

Atau, kartu dengan laporan data pra-banjir tentang saluran pembuangan.

  "disaster_type": "prep",
  "card_data":{
    "report_type":"drain"
  }

GET /cards/:cardId

Dapatkan detail kartu:

Berikut adalah panggilan sederhana untuk GET kartu:

curl -X GET -H "X-Api-Key: API_KEY_GOES_HERE" "https://data.petabencana.id/cards/abcdefg"

Kartu telah ditemukan:

{
  "statusCode": 200,
  "result": {
    "pkey": "2",
    "card_id": "abcdefg",
    "username": "user",
    "network": "test",
    "language": "en",
    "received": true,
    "report_id": "1"
  }
}

Kartu tidak ada:

{
  "statusCode": 404,
  "found": false,
  "result": null
}

PUT /cards/:cardId

Memperbarui kartu dengan detail laporan kejadian bencana:

Berikut adalah panggilan sederhana untuk PUT kartu:

curl -X PUT -H "X-Api-Key: API_KEY_GOES_HERE" -d '{
    "text": "test card",
    "disaster_type": "flood"
    "card_data":
      {
        "report_type": "flood",
        "flood_depth": 101
      },
    "created_at":"2016-12-09T11:32:52.011Z",
    "location": {
        "lat": -6.149531,
        "lng": 106.869342
    }
}' "https://data.petabencana.id/cards/abcdefg"

Kartu telah berhasil dibuat:

{
  "statusCode": 200,
  "cardId": "abcdefg",
  "created": true
}

Kartu tidak ada:

{
  "statusCode": 404,
  "cardId": "abcdefg",
  "message": "No card exists with id 'abcdefg'"
}

Laporan sudah ada untuk kartu:

{
  "statusCode": 409,
  "cardId": "abcdefg",
  "message": "Report already received for card 'abcdefg'"
}

GET /cards/:cardId/images

GET URL S3 yang ditandai untuk mengunggah laporan kartu, ini harus dilakukan setelah laporan kartu dibuat dan hanya satu gambar yang ada untuk kartu tertentu.

CATATAN: Setelah gambar dikirim, proses sisi server mengkompres gambar ke ukuran standar dan mungkin ada sedikit jeda waktu beberapa detik sebelum gambar tampil secara "live".

Berikut ini panggilan sederhana GET untuk URL S3 baru yang telah ditandai untuk unggahan gambar:

curl -X GET \
  https://api-server-dev.riskmap.in/cards/HJID8CWN-/images

URL S3 yang telah ditandai berhasil dibuat:

{"signedRequest":"https://riskmap-image-uploads.s3.ap-south-1.amazonaws.com/originals/BJbTHR-Vb.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAJFMR3NR7BXZ5X7DA%2F20170629%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20170629T012002Z&X-Amz-Expires=900&X-Amz-Signature=ad10a53555205fa18ecfa07da52eb0349ed1c8bda66fe2de0fa9c445c61b7c62&X-Amz-SignedHeaders=host","url":"https://s3.ap-south-1.amazonaws.com/riskmap-image-uploads/originals/BJbTHR-Vb.jpg"}

Last updated