API sürümleme (ARCH7202)

Anahtar php.quality.api-versioning · Önem info · Kategori quality

Açık sürümü olmayan API uç noktaları, geriye dönük uyumsuz değişiklikleri istemciler için kırıcı hale getirir. Sürümü yola veya özniteliğe ekleyin.

Hatalı

<?php
#[Route('/users', methods: ['GET'])]
public function index(): JsonResponse
{
    return $this->json($this->repo->all());
}

Doğru

<?php
#[Route('/v1/users', methods: ['GET'])]
public function index(): JsonResponse
{
    return $this->json($this->repo->all());
}

Düzeltme

Rota yoluna veya öznitelikteki sürüm bilgisine açık bir API sürümü ekleyin.