Aplikasi ini adalah lanjutan Dot Test Sprint 1. (https://github.com/ridhorobby50/dot-test-sprint1) Pastikan anda memiliki database yang ada dari Sprint 1
- Copy isi dari .env.example dan buatlah file .env. Pastekan isi dari .env.example ke file .env yang baru dibuat
- Ubah Detail pada env dari DB_HOST sampai DB_PASSWORD sesuai dengan database yang digunakan di sprint 1
- Jalankan perintah "composer install" untuk install third party dan dependecies yang dibutuhkan
- Jalankan perintah "php artisan jwt:secret" untuk membuat jwt secret yang akan diletakkan di .env
- Jalankan perintah "php artisan migrate" untuk membuat table users
- Jalankan perintah "php artisan db:seed --class=UserSeeder" untuk mengisi table users
- Jika sudah semua maka anda bisa menjalankan aplikasi dengan menjalankan perintah "php artisan serve"
- Ada 3 endpoint yang bisa diakses, yakni :
| Endpoint | Payload | Authorized? |
|---|---|---|
| api/v1/login | raw body :email, password | no |
| api/v1/search/provinces | Param query : origins (1 / 0) | Yes |
| api/v1/search/cities | Param query : origins (1 / 0) | Yes |
-
api/v1/login adalah endpoint yang harus diakses terlebih dahulu untuk mendapatkan token. Masukkan salah satu email yang ada di database dan gunakan password "dot-sprint2". Akses dengan method post dan data di raw body.Maka akan mendapatkan response token yang valid.
-
api/v1/search/provinces dan api/v1/search/cities wajib mengirimkan Bearer token pada header. Secara default akan mengambil data dari database, namun jika ditambahkan param query origins=1, maka akan mengambil data langsung dari rajaOngkir. Struktur data pada response akan terlihat berbeda untuk menunjukkan perbedaan antara data rajaongkir dan data yang berasal dari database
- Ada beberapa test yang dibuat dalam unit test, berikut listnya:
- Login Test (Success)
- Login Test (MustEnterEmailAndPassword)
- Get City Test (Unauth)
- Get City Test (Authorized) from DB
- Get City Test (Authorized) from RajaOngkir
- Get Province Test (Unauth)
- Get Province Test (Authorized) from DB
- Get Province Test (Authorized) from RajaOngkir
- Untuk mencoba testnya, silahkan jalankan perintah "php artisan test"
- Anda bisa melihat list api yang ada dengan mengakses url {HOST}/api/documentation, contoh : http://localhost:8000/api/documentation, pastikan anda telah mengubah value L5_SWAGGER_CONST_HOST di env, sesuaikan dengan link host anda.