RESTте ресурстарды аташтын кандай эрежелери бар?

RESTful API-де ресурстар аталыштар менен аталат, алар коллекциялар же объекттердин үлгүлөрүн көрсөтөт.

Аталыш берүү эрежелери:

• Коллекциялар үчүн көптүк формасын колдонуңуз: GET /products, POST /users.
• Белгилүү бир ресурска кирүү үчүн идентификаторду колдонуңуз: GET /products/123, PUT /users/john_doe.
• Ичке ресурстар иерархиялык түрдө аталат: GET /users/john_doe/orders, DELETE /products/456/reviews/789.
• URL-да иш-аракеттерди глаголдор менен көрсөтүүдөн алыс болуңуз: GET /getAllProducts ордуна GET /products колдонуу. HTTP ыкмалары (GET, POST, PUT, DELETE) иш-аракетти өзү көрсөтүп турат.
• Кичинекей тамгаларды колдонуңуз: GET /users GET /Usersка салыштырмалуу артыкчылыкка ээ.
• Сөздөрдү тире менен бөлүңүз: GET /product-categories GET /productCategoriesка салыштырмалуу артыкчылыкка ээ.
• Файл кеңейтмелерин колдонбоңуз: GET /users/john_doe GET /users/john_doe.json ордуна. Маалымат түрү Content-Type жана Accept башталыштарында аныкталат.
• Фильтрлөө, сорттоо жана беттөө үчүн суроо параметрлерин колдонуңуз: GET /products?category=electronics&sort=price&limit=10&offset=0.

Мисал:

// ID 1 болгон колдонуучу үчүн бардык буйрутмалардын тизмесин алуу
// GET /users/1/orders

// Жаңы продукт түзүү
// POST /products

// ID 42 болгон продукттун деталдарын алуу
// GET /products/42

// ID 5 болгон продукт үчүн ID 10 болгон пикирди жаңыртуу
// PUT /products/5/reviews/10