a2aproject / a2aproject/A2A

[Bug]: Clarify the Content-Type for errors for the HTTP+JSON transport.

Offen Anfängerfreundlich
#1,685 1 Kommentar 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen
triaged
Vorherrschende Sprache
Shell
Sterne
25.7k
Forks
2.6k
Ø Merge
3 T. 6 Std.
Gemergte PRs (30 T.)
16

Beschreibung

### What happened?

The spec does not specify what is the content-type for errors for the HTTP+JSON transport, `application/json` or `application/problem+json`.

Given that errors now follows https://google.aip.dev/193 instead of RFC 9457, I'd assume that `application/json` is the right content type for error responses

https://github.com/a2aproject/A2A/pull/1600 seems to be the cause of this missing information (the mention of `application/problem+json` was removed in this PR).

Note that there are still 2 error examples with `application/problem+json` in the spec:

* https://github.com/a2aproject/A2A/blob/173695755607e884aa9acf8ce4feed90e32727a1/docs/specification.md#64-version-negotiation-error
* https://github.com/a2aproject/A2A/blob/173695755607e884aa9acf8ce4feed90e32727a1/docs/specification.md#pagination-example

while another error example now uses `application/json`:

* https://github.com/a2aproject/A2A/blob/173695755607e884aa9acf8ce4feed90e32727a1/docs/specification.md#116-error-handling

If there is an agreement, I propose to:

* use `application/son` consistently for JSON-RPC and HTTP+JSON error examples
* Update https://github.com/a2aproject/A2A/blob/173695755607e884aa9acf8ce4feed90e32727a1/docs/specification.md?plain=1#L2212:
> - **Content-Type:** `application/json` for requests and responses (including error responses)

* https://github.com/a2aproject/A2A/blob/173695755607e884aa9acf8ce4feed90e32727a1/docs/specification.md?plain=1#L2729:
> - **Content-Type:** `application/json` for requests and responses (including error responses)

### Relevant log output

```shell

```

### Code of Conduct

- [x] I agree to follow this project's Code of Conduct

Beitragsleitfaden

Beitragsleitfaden öffnen

Rechercherichtung

The issue points to specific lines in docs/specification.md where Content-Type headers for error responses need to be updated. Review the linked PR #1600 and the three error examples cited to understand the inconsistency. The task is to change 'application/problem+json' to 'application/json' in the two remaining examples and ensure the specification text at lines 2212 and 2729 correctly states the content type for error responses.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Bereich
documentation
Issue-Typ
Dokumentation
Schwierigkeit
1/5
Geschätzter Aufwand
Unter einer Stunde
Aktivitätsstatus
Veraltet
Klarheit
Klar beschrieben
Anfängerfreundlichkeit
75/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.