RESTful API долбоолоо
Маалыматтарды түшүнүктүү жана болжолдуу URL менен методдордун топтомуна айландыруу
- маалыматтарды ресурстар катары моделдеп, алардын URL дарегин долбоолоо,
- HTTP методдорун түзүү/окуу/жаңылоо/өчүрүү менен дал келтирүү жана кайсынысы коопсуз же идемпотенттүү экенин билүү,
- ийгилик жана ката учурунда туура абал коддорун кайтаруу,
- REST эмне үчүн абалды сактабай турганын түшүндүрүү жана ошону эске алуу менен долбоолоо.
1. Ресурстар: аракеттерди эмес, зат атоочторду моделдейбиз
REST'тин жүрөгү — бул ресурс: системаңыз билген нерсе, мисалы тапшырма, колдонуучу же буйрутма. Ресурс — бул зат атооч. Жаңыдан баштагандардын катасы — этиштердин тегерегинде долбоолоо: /createTask, /getTask, /deleteTask — бул ар бир жаңы аракет жаңы URL талап кылат жана кардар алардын баарын жаттоого мажбур болот дегенди билдирет.
REST'те баары тескери. Сиз ар бир ресурска бир URL берип, аракетти HTTP методуна сүрөттөткө уруксат бересиз:
- коллекция көптүк сандагы жолдо жашайт:
/tasks - өзүнчө элемент — анын астында идентификатор боюнча:
/tasks/42
Салыштыруу. Картотека шкафын элестетиңиз. /tasks — «Тапшырмалар» деп жазылган тартма; /tasks/42 — анын ичиндеги бир папка. Сиз эч качан тартманы «тапшырмалар тартмасын ач» деп жазбайсыз — тартма зат атооч, ал эми папкаларды ачуу, кошуу же алып салуу — бул анын үстүнөн жасаган өзүнчө аракеттер. HTTP методдору дал ушул аракеттер.