Các loại

Open Cloud đại diện yêu cầu và trả lời payloads như JSON tiêu chuẩn . Các loại ngữ cầu JSON đặt biệt có là text, giá trị, đối tượng, hệ đệm, số và chuỗi. Một số loại có lưu ý đặc biệt để đại diện các loại dữ liệu cụ thể, được mô tả trong các mục dưới đây.

Dấu giờ

Sử dụng RFC 3339, nơi sản lượng được tạo luôn luôn là Z-normalized và sử dụng 0, 3, 6 hoặc 9 số thập phân. Offsets khác ngoài "Z" cũng được chấp nhận.

Dấu hiệu Thời gian
{ "timestamp": "1972-01-01T10:00:20.021Z" }

Thời lượng

Sản lượng tạo luôn luôn được tạo bởi 0, 3, 6 hoặc 9 chuỗi số thập phân, tùy theo độ chính xác yêu cầu, theo dấu hiệu "s". Bất kỳ số thập phân nào cũng được chấp nhận miễn là nó ph

Thời lượng ví dụ
{
  "duration-9": "1.000340012s",
  "duration-0": "1s"
}

Bản tải

Dữ liệuバイト được mã hóa dưới dạng chuỗi bằng cách sử dụng bản mã hóa base64 tiêu chuẩn với dấu chấm câu. Hoặc dữ liệu base64 mã hóa tiêu chuẩn hoặc dữ liệu base64 với hoặc không có dấu chấm câu được hỗ trợ.

Ví dụ Bytes
{
  "bytes": "YWJjMTIzIT8kKiYoKSctRbLx+"
}

Mặt nạ

Một FieldMask là một chuỗi mô tả các trường để hành động khi thực hiện một yêu cầu. Để xây dựng một FieldMask, bạn đặt tên các trường JSON được dấu chấm câu trong một chuỗi. Ví dụ, cho tài nguyên sau đây:

Tài nguyên JSON ví dụ
{
  "foo": {
    "a": "c",
    "b": "d"
  },
  "bar": "x",
  "baz": "y"
}

Nếu bạn muốn chỉ định một mặt nạ trường để cập nhật giá trị chỉ của foo.b và bar, mặt nạ trường sẽ xem như: foo.b, bar

Trong Open Cloud, cập nhật các phương pháp hỗ trợ một máy chủ trang bị một máy chủ trang bị máy chủ như một giá trị.

Tiền

Nói chung, để xác định giá, loại Money có một mã tiền tệ ba chữ cái (như được định nghĩa trong ISO 4217) và một số lượng, sử dụng kiểu Decimal . Ví dụ, một sản phẩm 17.99$ của Cửa hàng người sáng tạo trô

"myPrice": {
  "currencyCode": "USD",
  "quantity": {
    "significand": 1799,
    "exponent": -2
  }
}

Dã

Đại diện một số thập phân trong một hình dạng tương tự như khoa học, với các chữ số quan trọng và một hệ số nhân.

Ví dụ:

• 17

  {"significand": 17, "exponent": 0} hoặc chỉ {"significand": 17}

• 0.005

  {"significand": -5, "exponent": -3}

• 33.5 triệu (33,500,000)

  {"significand": 335, "exponent": 5}

• 11/8 (1.375)

  {"significand": 1375, "exponent": -3}

Khi exponent lớn hơn 0, nó đại diện cho số lượng các số sau cùng sau các chữ số đáng kể. Khi exponent nhỏ hơn 0, nó đại diện cho số lượng các chữ số sau