#### Путь (path)

"Путь" это часть URL, после первого символа `/`, следующего за именем домена.

Для URL:

```
https://example.com/items/foo
```

...путь выглядит так:

```
/items/foo
```

/// info | Дополнительная иформация

Термин "path" также часто называется "endpoint" или "route".

///

```

</div>

## ✅ ⚫️

👆 🔜 💪 ✅ ⚫️ 👆 ☁ 📦 📛, 🖼: <a href="http://192.168.99.100/items/5?q=somequery" class="external-link" target="_blank">http://192.168.99.100/items/5?q=somequery</a> ⚖️ <a href="http://127.0.0.1/items/5?q=somequery" class="external-link" target="_blank">http://127.0.0.1/items/5?q=somequery</a> (⚖️ 🌓, ⚙️ 👆 ☁ 🦠).

👆 🔜 👀 🕳 💖:

```JSON
{"item_id": 5, "q": "somequery"}
```

///

Dat betekent: “de variabele `items` is een `list`, en elk van de items in deze list is een `str`”.

/// tip

Als je Python 3.9 of hoger gebruikt, hoef je `List` niet te importeren uit `typing`, je kunt in plaats daarvan hetzelfde reguliere `list` type gebruiken.

///

Door dat te doen, kan je editor ondersteuning bieden, zelfs tijdens het verwerken van items uit de list:

    /**
     * Default constructor.
     */
    public StemmerOverrideService() {
        // Default constructor
    }

    /**
     * Retrieves a paginated list of stemmer override items from the specified dictionary.
     *
     * This method fetches stemmer override entries with pagination support, updating
     * the provided pager with the current page state and navigation information.
     *

                                                <la:option value=""/>
                                                <c:forEach var="hn" varStatus="s"
                                                           items="${handlerNameItems}">
                                                    <la:option value="${f:u(hn.value)}">${f:h(hn.label)}</la:option>
                                                </c:forEach>

                                            <tbody>
                                            <c:forEach var="data" varStatus="s"
                                                       items="${synonymItemItems}">
                                                <tr
                                                        data-href="${contextPath}/admin/dict/synonym/details/${f:u(dictId)}/4/${f:u(data.id)}">

                                                <tbody>
                                                <c:forEach var="data" varStatus="s"
                                                           items="${requestHeaderItems}">
                                                    <tr
                                                            data-href="${contextPath}/admin/reqheader/details/4/${f:u(data.id)}">

                                        <th><la:message
                                                key="labels.reqheader_web_crawling_config"/></th>
                                        <td><c:forEach var="item" items="${webConfigItems}">
                                            <c:if test="${webConfigId==item.value}">${f:h(item.label)}</c:if>
                                        </c:forEach> <la:hidden property="webConfigId"/></td>

    * `url` (**requerido**): un `str` con la URL para la documentación externa.

### Crear metadata para etiquetas

Probemos eso en un ejemplo con etiquetas para `users` y `items`.

Crea metadata para tus etiquetas y pásala al parámetro `openapi_tags`:

{* ../../docs_src/metadata/tutorial004.py hl[3:16,18] *}

     * `url` (**erforderlich**): ein `str` mit der URL für die externe Dokumentation.

### Metadaten für Tags erstellen

Versuchen wir das an einem Beispiel mit Tags für `users` und `items`.

Erstellen Sie Metadaten für Ihre Tags und übergeben Sie sie an den Parameter `openapi_tags`:

{* ../../docs_src/metadata/tutorial004.py hl[3:16,18] *}