← Kõik teemad

REST API

Endpointid, HTTP-meetodid, URL-i parameetrid, JSON ja vastuste staatused.

Küsimus 1/17Õige: 0Vale: 0

Küsimused ja selgitused

Siit leiad iga küsimuse selgituse. Kui soovid end proovile panna, tee esmalt ülalolev viktoriin.

  1. Mis on API?

    API määrab reeglid, mille järgi üks rakendus saab teiselt rakenduselt küsida andmeid või tegevust.

  2. Mis on endpoint REST API-s?

    Aadressilt /api/v1/users saab klient küsida kasutajate loendit, /api/v1/users/42 aga viitab ühele kasutajale. Tee ütleb API-le, millise ressursiga töötada.

  3. Millist HTTP-meetodit kasutatakse tavaliselt andmete saamiseks?

    GET /api/v1/orders/42 loeb tellimuse 42 andmeid. Sama tellimuse uuesti küsimine ei tohiks seda muuta; ressursi muutmiseks kasutatakse teisi meetodeid.

  4. Millist HTTP-meetodit kasutatakse tavaliselt ressursi loomiseks?

    POST saadab serverile tavaliselt uue ressursi andmed, näiteks uue kasutaja või tellimuse andmed.

  5. Millist HTTP-meetodit kasutatakse tavaliselt ressursi kustutamiseks?

    DELETE /api/v1/orders/42 palub serveril eemaldada tellimuse 42. Tee määrab ühe ressursi, seega ei tohiks päring eemaldada kogu tellimuste loendit.

  6. Mis vahe on PUT-il ja PATCH-il?

    PUT-i kasutatakse ressursi täielikuks asendamiseks, PATCH-i osaliseks muutmiseks, näiteks ainult tellimuse staatuse muutmiseks.

  7. Mis on path parameter?

    Marsruudis /api/v1/users/:id asendab aadressi /api/v1/users/42 väärtus 42 muutuja :id. Nii saab server aru, millise kasutaja andmeid küsiti.

  8. Mis on query parameter?

    Query parameter’eid kasutatakse sageli filtreerimiseks, sortimiseks või lehekülgede kaupa kuvamiseks, näiteks ?status=paid.

  9. Kus edastatakse tavaliselt andmed ressursi loomisel?

    POST-päringu korral asuvad uue ressursi andmed tavaliselt päringu sisus.

  10. Millises vormingus edastab REST API sageli andmeid?

    JSON on levinud tekstivorming struktureeritud andmete vahetamiseks kliendi ja serveri vahel.

  11. Mida tähendab tavaliselt HTTP-staatus 200?

    Edukas GET /api/v1/users/42 tagastab tavaliselt 200 OK koos kasutaja andmetega. See näitab edu, kuid ei tähenda uue ressursi loomist; loomisel kasutatakse sageli 201 Created.

  12. Mida tähendab tavaliselt HTTP-staatus 201?

    201 Created tagastatakse tavaliselt pärast ressursi, näiteks uue kasutaja või tellimuse, edukat loomist.

  13. Mille poolest erinevad staatused 400, 401, 403 ja 404?

    Need on kliendipoolsed vead: päring võib olla vigane, kasutaja pole sisse logitud, tal puuduvad õigused või ta küsib olematut aadressi.

  14. Mida tähendab HTTP-staatus 500?

    500 Internal Server Error tähendab, et server ei suutnud päringut sisemise probleemi tõttu korrektselt töödelda.

  15. Kus on päringus GET /api/v1/users/42 path parameter?

    42 asub URL-i tees ja tähistab konkreetset kasutajat, seega on see path parameter.

  16. Kus on päringus GET /api/v1/users?status=active query parameter?

    status=active asub pärast märki ? ning annab päringule lisatingimuse, seega on see query parameter.

  17. Milline URL sisaldab query parameter’it?

    Query parameter’id algavad pärast märki ?. Selles näites edastab status=paid tellimuste loendi filtri.