Sobes.tech
Middle

Ի՞նչ կանոններ կան ռեսուրսների անվանման համար REST-ում, որոնք դու գիտես։

sobes.tech AI

Պատասխան AI-ից

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 10-ի վերանայումը ապրանքի ID 5-ի համար
// PUT /products/5/reviews/10