Recipe API

Caracteristicas

Crear
Listar
Ver detalles
Actualizar
Borrar

Endpoints

/recipes/
- GET Listar todas las recetas
- POST Crea recetas
/recipes/<recipe_id>/
- GET Ver detalles de receta
- PUT/PATCH Actualizar receta
- DELETE Borrar receta

APIView vs Viewsets

Una vista maneja un request a una URL, DRF usa clases con lógica reutilizable. DRF además soporta decoradores.

APIView y Viewsets son clases base falicitadas por DRF.

APIView

Concentradas alrededor de los metodos HTTP
Métodos de clase para los métodos HTTP GET, POST, PUT, PATCH, DELETE
Ofrece flexibilidad sobre toda la estuctura de las URL y la lógica usada para procesar estas peticiones
Util para APIs sin CRUD. Lógica a la medida, ej. auth, jobs, apis externas

Viewsets

Concentradas alrededor de aciones
- Retrive, list, update, partial update, destroy
Mapea los modelos de Django
Usa rutas para generar URLs
Genial para operaciones CRUD en los modelos

Test Create Recipe

core/tests/test_models.py

from decimal import Decimal

...

from core import models

class ModelTests(TestCase):
    ...

    def test_create_recipe(self):
        """Test creating a recipe is successful."""
        user = get_user_model().objects.create_user(
            'test@example.com',
            'test123',
        )
        recipe = models.Recipe.objects.create(
            user=user,
            title='Nombre receta ejemplo',
            time_minutes=5,
            price=Decimal('5.50'),
            decription='Descripción de la receta de ejemplo'
        )

        self.assertEqual(str(recipe), recipe.title)

Creación del modelo

core/models.py

...

class Recipe(models.Model):
    """Recipe object."""
    user = models.ForeignKey(
        settings.AUTH_USER_MODEL,
        on_delete=models.CASCADE,
    )
    title = models.CharField(max_length=255)
    description = models.TextField(blank=True)
    time_minutes = models.IntegerField()
    price = models.DecimalField(max_digits=5,decimal_places=2, blank=True)
    link = models.CharField(max_length=255, blank=True)

    def __str__(self):
        return self.title

Agregar al panel de administración

core/admin.py

...
admin.site.register(models.Recipe)

Crear migraciones

docker compose run --rm app sh -c "python manage.py makemigrations"

[+] Creating 1/0
 ✔ Container recipes_api_django-db-1  Running  0.0s
Migrations for 'core':
  core/migrations/0002_recipe.py
    - Create model Recipe

2.6 KiB Raw Blame History