You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Jul 7, 2025. It is now read-only.
Copy file name to clipboardExpand all lines: draft-ietf-httpapi-deprecation-header.md
+11-11Lines changed: 11 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -87,11 +87,11 @@ Deprecation = sf-date
87
87
88
88
Servers MUST NOT include more than one `Deprecation` header field in the same response.
89
89
90
-
The date is the date when the resource was or will be deprecated. It is in the form of an Structured Field Dates as defined in Section 3.3.7 of [SFBIS].
90
+
The date is the date when the resource was or will be deprecated. It is in the form of an Structured Field Date as defined in Section 3.3.7 of [SFBIS].
91
91
92
-
The following example shows that the resource context has been deprecated on Friday, November 24, 2023 at 23:59:59 GMT:
92
+
The following example shows that the resource context has been deprecated on Friday, June 30, 2023 at 23:59:59 GMT:
93
93
94
-
Deprecation: @1700830799
94
+
Deprecation: @1688169599
95
95
96
96
The deprecation date can be in the future. This means that the resource will be deprecated at the indicated date in the future.
97
97
@@ -125,7 +125,7 @@ In this example the linked content provides additional information about depreca
125
125
126
126
The following example uses the same link header field, but also announces a deprecation date using a Deprecation header field:
@@ -138,10 +138,10 @@ In addition to the deprecation related information, if the resource provider wan
138
138
139
139
The timestamp given in the `Sunset` header field MUST NOT be earlier than the one given in the `Deprecation` header field.
140
140
141
-
The following example shows that the resource in context has been deprecated since Friday, November 24, 2023 at 23:59:59 GMT and its sunset date is Sunday, November 24, 2024 at 23:59:59 GMT.
141
+
The following example shows that the resource in context has been deprecated since Friday, June 30, 2023 at 23:59:59 GMT and its sunset date is Sunday, June 30, 2024 at 23:59:59 GMT. Please note that for historical reasons the Sunset HTTP header field uses a different data type for date.
142
142
143
-
Deprecation: @1700830799
144
-
Sunset: Sun, 24 Nov 2024 23:59:59 GMT
143
+
Deprecation: @1688169599
144
+
Sunset: Sun, 30 Jun 2024 23:59:59 GMT
145
145
146
146
# Resource Behavior
147
147
@@ -284,12 +284,12 @@ The following examples do not show complete HTTP interactions. They only show th
284
284
285
285
The first example shows a deprecation header field with date information:
286
286
287
-
Deprecation: @1700830799
287
+
Deprecation: @1688169599
288
288
289
289
The second example shows a deprecation header field with a link for the resource's deprecation policy. In addition, it shows the sunset date for the deprecated resource:
@@ -300,7 +300,7 @@ The second example shows a deprecation header field with a link for the resource
300
300
301
301
This revision has made the following changes:
302
302
303
-
* Date format is changed from IMF-fixdate rule as defined in {{Section 5.6.7 of HTTP}} to Structured Field for Dates as defined in Section 3.3.7 of [SFBIS].
303
+
* Date format is changed from IMF-fixdate rule as defined in {{Section 5.6.7 of HTTP}} to Structured Field for Date as defined in Section 3.3.7 of [SFBIS].
0 commit comments