a2aproject / a2aproject/A2A

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

Abierto Apto para principiantes
#1,685 1 comentario 0 reacciones 0 asignados Ver en GitHub
triaged
Lenguaje dominante
Shell
Estrellas
25.7k
Forks
2.6k
Merge medio
3 d 6 h
PR fusionados (30 d)
16

Descripción

### 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

Guía de contribución

Abrir la guía de contribución

Línea de trabajo

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.

Escrito por el modelo de indexación a partir del texto del issue.

Evaluación

Área
documentation
Tipo de issue
Documentación
Dificultad
1/5
Tiempo estimado
Menos de una hora
Estado de actividad
Estancado
Claridad
Bien especificado
Aptitud para principiantes
75/100

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.