{* ../../docs_src/body_updates/tutorial001_py310.py hl[28:33] *}

`PUT` se usa para recibir datos que deben reemplazar los datos existentes.

### Advertencia sobre el reemplazo { #warning-about-replacing }

Esto significa que si quieres actualizar el ítem `bar` usando `PUT` con un body que contenga:

```Python
{
    "name": "Barz",

        // Test the pattern used in getDefaultMappings/getDefaultIndexSettings
        // with a non-existent resource
        try {
            try (final InputStream is = getClass().getClassLoader().getResourceAsStream("non/existent/resource.json")) {
                if (is == null) {
                    throw new IOException("Resource not found: non/existent/resource.json");
                }
                // This line should not be reached

Por ejemplo, estaba claro que idealmente debería estar basado en las anotaciones de tipos estándar de Python.

También, el mejor enfoque era usar estándares ya existentes.

Entonces, antes de siquiera empezar a programar **FastAPI**, pasé varios meses estudiando las especificaciones de OpenAPI, JSON Schema, OAuth2, etc. Entendiendo su relación, superposición y diferencias.

## Diseño { #design }

        assertEquals("new_value1", retrievedValues[0]);
        assertEquals("new_value2", retrievedValues[1]);
    }

    public void test_getValuesNonExistentKey() {
        // Test getValues with non-existent key
        ExtractData data = new ExtractData();

        String[] values = data.getValues("nonexistent");
        assertNull(values);
    }

    public void test_getKeySet() {

```JSON
{
  "item": "The Foo Wrestlers"
}
```

But if the client requests `http://example.com/items/bar` (a non-existent `item_id` `"bar"`), that client will receive an HTTP status code of 404 (the "not found" error), and a JSON response of:

```JSON
{
  "detail": "Item not found"
}
```

/// tip

```JSON
{
  "item": "The Foo Wrestlers"
}
```

Mas se o cliente faz uma requisição para `http://example.com/items/bar` (ou seja, um não existente `item_id "bar"`), esse cliente receberá um HTTP status code 404 (o erro "não encontrado" — *not found error*), e uma resposta JSON:

```JSON
{
  "detail": "Item not found"
}
```

/// tip | Dica

    }

    @Test
    public void test_deleteNonExistent() throws Exception {
        SuggestWriterResult result = writer.delete(runner.client(), suggester.settings(), suggester.getIndex(), "non-existent-id");

        assertNotNull(result);
        assertFalse(result.hasFailure());
    }

    @Test
    public void test_deleteByQuery() throws Exception {
        SuggestItem[] items = new SuggestItem[3];

    * También puedes ayudar a revisar las traducciones creadas por otros.
* Para proponer nuevas secciones de documentación.
* Para corregir un issue/bug existente.
    * Asegúrate de agregar tests.
* Para agregar una nueva funcionalidad.
    * Asegúrate de agregar tests.
    * Asegúrate de agregar documentación si es relevante.

        assertTrue(result); // Should still return true even with no matches
    }

    @Test(expected = SuggesterException.class)
    public void testDeleteByQueryWithInvalidIndex() {
        // Test delete with non-existent index
        SuggestUtil.deleteByQuery(client, settings, "nonexistent_index", QueryBuilders.matchAllQuery());
    }

    @Test
    public void testDeleteScrollContext() {

### Frameworks REST para Flask { #flask-rest-frameworks }

Existen varios frameworks REST para Flask, pero después de invertir tiempo y trabajo investigándolos, encontré que muchos son descontinuados o abandonados, con varios problemas existentes que los hacían inadecuados.

### <a href="https://marshmallow.readthedocs.io/en/stable/" class="external-link" target="_blank">Marshmallow</a> { #marshmallow }