"""
Superficie de la API pública.

Está versionada desde el primer día. Publicar `/api/credentials` y versionar
después obliga a mantener para siempre una ruta sin versión, o a romper a quien
ya la integró: el prefijo cuesta nada ahora y evita las dos cosas.

La documentación se genera del esquema y el esquema del código. Escribirla
aparte garantiza que en algún momento diga algo que el código no hace, y este
producto se integra desde un pipeline de despliegue: una documentación que
miente ahí no es un inconveniente, es un despliegue roto (principio IV).
"""

from django.urls import include, path
from drf_spectacular.views import SpectacularAPIView, SpectacularSwaggerView

urlpatterns = [
    path('v1/', include(('config.api_v1', 'v1'), namespace='v1')),
    path('schema', SpectacularAPIView.as_view(), name='api-schema'),
    path(
        'docs',
        SpectacularSwaggerView.as_view(url_name='api-schema'),
        name='api-docs',
    ),
]