Pobierz Instrukcję

INSTRUKCJAPODŁĄCZANIA
SKLEPU
DOPLATFORMYmSHOPPING
RESTAPI
Użytkownikmożepodłączyćkażdysklepużywającwbudowanegointerfejsu
mShopping.Wtymcelumusiprzygotowaćpodstawowyadres,podktórym
będądostępnewszystkieakcjedlaRESTAPI,np:http://sklep.domain/restapi.AkcjetewysyłanesąodpowiednimimetodamiHTTP(np.POST,GET,PUT,
DELETE)izwracająresponsezestatusem200(jeślipowiodłosię)lub500jeśliwystąpiłbłąd.WprzypadkubłęduResponsemanastępującąstrukturę:
JSONResponse (Status500):
[
'message'=>'Komunikat błedu',
]
KROK1:TOKENUWIERZYTELNIAJĄCY
GET/get-token
JSONResponse (Status200):
[
'token'=>'token uwierzytelniający',
]
KROK2:LOGOWANIENAKONTO
UŻYTKOWNIKA
POST/process-login
Body:
[
'login'=>'Login',
'pass'=>'Hasło',
]
JSONResponse(Status200):
[
'user_id' =>'idużytkownika',
'user_name' =>'nazwa użytkownika',
]
KROK3:WYLOGOWYWANIE
POST/process-login
Body:
[
'user_id'=>'Idużytkownika',
]
JSONResponse(Status200):
[
'result'=>true,
]
KROK4(1):POBIERANIEDRZEWKAKATEGORII
GET/get-categories
JSONResponse (Status200):
[
[
'id'=>'Idkategorii',
'name'=>'Nazwakategorii',
'children'=>null,
],
[
'id'=>'Idkategorii',
KROK4(2):POBIERANIEDRZEWKAKATEGORII
'id'=>'Idkategorii',
'name'=>'Nazwakategorii',
'children'=>[
[
'id'=>'Idpodkategorii',
'name'=>'Nazwapodkategorii',
'children'=>//nulllubkolejnepodkategorie
]
],
],
(...)
]
KROK5:LISTAPRODUKTÓWWKATEGORII
GET/get-products/:cat_id://cat_id - idkategorii
JSONResponse (Status200):
[
[
'id'=>'Idproduktu',
'name'=>'Nazwaproduktu',
'desc'=>'Opis',
'price'=>100.21,//cenaproduktu (float)
'img' =>'adres_url_obrazka',
],
(...)
]
KROK6:DODAWANIEPRODUKTUDO
KOSZYKA
GET/get-products/:cat_id://cat_id - idkategorii
JSONResponse (Status200):
[
[
'id'=>'Idproduktu',
'name'=>'Nazwaproduktu',
'desc'=>'Opis',
'price'=>100.21,//cenaproduktu (float)
'img' =>'adres_url_obrazka',
],
(...)
]
KROK7:DODAWANIEPRODUKTUDO
KOSZYKA
PUT/cart/update-products
Body:
[
[
'prod_id'=>'idproduktu',
'qty'=> 'Cenaproduktu',
],
(...)
]
JSONResponse (Status200):
[
[
'result'=> true
],
]
KROK8:POBIERANIEZAWARTOŚCIKOSZYKA
GET /cart/get
JSONResponse (Status200):
[
'products'=>[
[
'id' =>'idproduktu',
'qty'=>'ilość',
],
(...)
]
'base_price' => 350,//kwotapełna,bezzniżki
'discount'=>100,//zniżka
'total_price' =>250,//kwotaostateczna(base_price - discount)
]
KROK9:ZŁOŻENIEZAMÓWIENIA
POST/cart/order
Body:
[
'first_name'=>'Imię',
'last_name' =>'Nazwisko',
'city'=>'Miasto',
'address'=>'Ulicainumerdomu/mieszkania',
'postcode'=>'kodpocztowy',
'telephone'=>'telefonkontaktowy',
]
JSONResponse(Status200):
[
[
'result'=>true
],
]