Kesalahan

Bagian berikut menggambarkan model kesalahan untuk v2 dan v1 resource methods, masing-masing.

Model Kesalahan Sumber Daya v2

Secara default, metode sumber daya menjawab dengan status 200 OK. Saat permintaan gagal, Open Cloud menghasilkan kode kesalahan standar. Semua kode kesalahan memiliki format yang sama, yang termasuk:

• code - Represents status HTTP.
• message - Pesan yang menjelaskan kesalahan.
• details - Objek yang berisi lebih banyak informasi spesifik tentang kesalahan.

Contoh Kesalahan
{
  "code": "INVALID_ARGUMENT",
  "message": "The provided filter is invalid.",
  "details": [
    {
      ...
    }
  ]
}

Kode

Tabel berikut menjelaskan nilai yang mungkin untuk code .

v1 Model Kesalahan Sumber Daya

Semua tanggapan kesalahan memiliki format yang sama, standar, yang termasuk:

• Sebuah field error , yang merupakan penyebab tingkat tinggi yang berlaku untuk semua Open Cloud endpoints.
• Kesalahan penjelasan message , yang menjelaskan lebih lanjut tentang kesalahan tersebut.
• Sebuah objek errorDetails , yang menyediakan lebih banyak informasi tentang kesalahan yang spesifik untuk setiap API.

Untuk menganalisis penyebab akar dari kesalahan, mengacu pada nilai dari error field dan errorDetails field. Gunakan message field sebagai tambahan untuk penanganan kesalahan, karena kadang-kadang mungkin tidak mencakup tingkat level rincian yang sama dengan 1> errorDetails1> field.

Contoh Tanggapan Standar DataStores
{
  "error": "INVALID_ARGUMENT",
  "message": "Invalid cursor.",
  "errorDetails": [
    {
      "errorDetailType": "DatastoreErrorInfo",
      "datastoreErrorCode": "InvalidCursor"
    }
  ]
}

Jawaban error contoh menunjukkan tingkat tinggi Open Cloud error sebagai INVALID_

Semua data yang dipesan menyimpan tanggapan kesalahan memiliki format yang sama, yang termasuk:

Contoh Tanggapan Kesalahan Toko DataStores
{
  "code": "INVALID_ARGUMENT",
  "message": "Invalid cursor."
}

The code akan berisi beberapa string kesalahan tingkat tinggi sementara the message akan berisi rincian spesifik terkait kesalahan

Kode

Lihat tabel berikut untuk menyajikan ringkasan dari semua kesalahan Open Cloud tingkat tinggi.