[httpapi] [Technical Errata Reported] RFC9457 (7731)

RFC Errata System <rfc-editor@rfc-editor.org> Thu, 14 December 2023 08:00 UTC

Return-Path: <wwwrun@rfcpa.amsl.com>
X-Original-To: httpapi@ietfa.amsl.com
Delivered-To: httpapi@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 0F056C14CE38 for <httpapi@ietfa.amsl.com>; Thu, 14 Dec 2023 00:00:42 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.657
X-Spam-Level:
X-Spam-Status: No, score=-1.657 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, CTE_8BIT_MISMATCH=0.001, HEADER_FROM_DIFFERENT_DOMAINS=0.249, RCVD_IN_ZEN_BLOCKED_OPENDNS=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01, URIBL_BLOCKED=0.001, URIBL_DBL_BLOCKED_OPENDNS=0.001, URIBL_ZEN_BLOCKED_OPENDNS=0.001] autolearn=no autolearn_force=no
Received: from mail.ietf.org ([50.223.129.194]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id PqMguba3VeMz for <httpapi@ietfa.amsl.com>; Thu, 14 Dec 2023 00:00:38 -0800 (PST)
Received: from rfcpa.amsl.com (rfcpa.amsl.com [50.223.129.200]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 08CC5C14CE3B for <httpapi@ietf.org>; Thu, 14 Dec 2023 00:00:38 -0800 (PST)
Received: by rfcpa.amsl.com (Postfix, from userid 499) id C84E919864E3; Thu, 14 Dec 2023 00:00:37 -0800 (PST)
To: mnot@mnot.net, erik.wilde@dret.net, sanjay.dalal@cal.berkeley.edu, superuser@gmail.com, francesca.palombini@ericsson.com, darrel@tavis.ca, rsalz@akamai.com
From: RFC Errata System <rfc-editor@rfc-editor.org>
Cc: roman.kovarik@magnolia-cms.com, httpapi@ietf.org, rfc-editor@rfc-editor.org
Content-Type: text/plain; charset="UTF-8"
Message-Id: <20231214080037.C84E919864E3@rfcpa.amsl.com>
Date: Thu, 14 Dec 2023 00:00:37 -0800
Archived-At: <https://mailarchive.ietf.org/arch/msg/httpapi/fj9TAH6my-kmw7wA_KOlVKCF_V8>
X-Mailman-Approved-At: Thu, 14 Dec 2023 07:01:18 -0800
Subject: [httpapi] [Technical Errata Reported] RFC9457 (7731)
X-BeenThere: httpapi@ietf.org
X-Mailman-Version: 2.1.39
Precedence: list
List-Id: Building Blocks for HTTP APIs <httpapi.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/httpapi>, <mailto:httpapi-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/httpapi/>
List-Post: <mailto:httpapi@ietf.org>
List-Help: <mailto:httpapi-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/httpapi>, <mailto:httpapi-request@ietf.org?subject=subscribe>
X-List-Received-Date: Thu, 14 Dec 2023 08:00:42 -0000

The following errata report has been submitted for RFC9457,
"Problem Details for HTTP APIs".

--------------------------------------
You may review the report below and at:
https://www.rfc-editor.org/errata/eid7731

--------------------------------------
Type: Technical
Reported by: Roman Kovařík <roman.kovarik@magnolia-cms.com>

Section: appendix-A

Original Text
-------------
# NOTE: '\' line wrapping per RFC 8792
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "An RFC 7807 problem object",
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "format": "uri-reference",
      "description": "A URI reference that identifies the \
problem type."
    },
    "title": {
      "type": "string",
      "description": "A short, human-readable summary of the \
problem type."
    },
    "status": {
      "type": "integer",
      "description": "The HTTP status code \
generated by the origin server for this occurrence of the problem.",
      "minimum": 100,
      "maximum": 599
    },
    "detail": {
      "type": "string",
      "description": "A human-readable explanation specific to \
this occurrence of the problem."
    },
    "instance": {
      "type": "string",
      "format": "uri-reference",
      "description": "A URI reference that identifies the \
specific occurrence of the problem. It may or may not yield \
further information if dereferenced."
    }
  }
}

Corrected Text
--------------
# NOTE: '\' line wrapping per RFC 8792
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "An RFC 7807 problem object",
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "format": "uri-reference",
      "description": "A URI reference that identifies the \
problem type."
    },
    "title": {
      "type": "string",
      "description": "A short, human-readable summary of the \
problem type."
    },
    "status": {
      "type": "integer",
      "description": "The HTTP status code \
generated by the origin server for this occurrence of the problem.",
      "minimum": 100,
      "maximum": 599
    },
    "detail": {
      "type": "string",
      "description": "A human-readable explanation specific to \
this occurrence of the problem."
    },
    "instance": {
      "type": "string",
      "format": "uri-reference",
      "description": "A URI reference that identifies the \
specific occurrence of the problem. It may or may not yield \
further information if dereferenced."
    }
  },
  "additionalProperties": true
}


Notes
-----
As the schema doesn't have  "additionalProperties": true, the schema validation fails with additional fields although those are allowed according to https://www.rfc-editor.org/rfc/rfc9457#name-extension-members. Also the example in https://www.rfc-editor.org/rfc/rfc9457#name-the-problem-details-json-ob fails the validation for the same reason.

Instructions:
-------------
This erratum is currently posted as "Reported". (If it is spam, it 
will be removed shortly by the RFC Production Center.) Please
use "Reply All" to discuss whether it should be verified or
rejected. When a decision is reached, the verifying party  
will log in to change the status and edit the report, if necessary.

--------------------------------------
RFC9457 (draft-ietf-httpapi-rfc7807bis-07)
--------------------------------------
Title               : Problem Details for HTTP APIs
Publication Date    : July 2023
Author(s)           : M. Nottingham, E. Wilde, S. Dalal
Category            : PROPOSED STANDARD
Source              : Building Blocks for HTTP APIs
Area                : Applications and Real-Time
Stream              : IETF
Verifying Party     : IESG