From e886303310e362d8e062ccddd6adb89a0e745c1a Mon Sep 17 00:00:00 2001 From: Daniel Smith Date: Fri, 8 Jun 2018 13:46:32 -0700 Subject: Proto is our default storage serialization; we can't break it --- contributors/devel/api-conventions.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/contributors/devel/api-conventions.md b/contributors/devel/api-conventions.md index 0243dbd8..7a614fff 100644 --- a/contributors/devel/api-conventions.md +++ b/contributors/devel/api-conventions.md @@ -742,7 +742,9 @@ APIs may return alternative representations of any resource in response to an Accept header or under alternative endpoints, but the default serialization for input and output of API responses MUST be JSON. -Protobuf serialization of API objects are currently **EXPERIMENTAL** and will change without notice. +A protobuf encoding is also accepted for built-in resources. As proto is not +self-describing, there is an envelope wrapper which describes the type of +the contents. All dates should be serialized as RFC3339 strings. -- cgit v1.2.3