# Panduan Testing & Verifikasi API

## Cara Testing API

### 1. Test dengan cURL (Command Line)

#### Test Health Check
```bash
curl http://localhost:8000/health
```

#### Test Login
```bash
curl -X POST http://localhost:8000/timo/login \
  -H "Content-Type: application/json" \
  -d '{"username":"testuser","password":"testpass","fcm_token":"test_token"}'
```

#### Test Cek SL
```bash
curl -X POST http://localhost:8000/timo/cek_sl \
  -H "Content-Type: application/json" \
  -d '{"token":"1","no_sl":"123456"}'
```

#### Test Request Pembayaran
```bash
curl -X POST http://localhost:8000/timo/request_pembayaran \
  -H "Content-Type: application/json" \
  -d '{"token":"1","no_sl":"123456","nama_bank":"BCA","no_rek":"1234567890"}'
```

### 2. Test dengan Postman

1. Import collection (jika ada)
2. Atau buat request manual:
   - Method: POST
   - URL: `http://localhost:8000/timo/login`
   - Headers: `Content-Type: application/json`
   - Body (raw JSON):
     ```json
     {
       "username": "testuser",
       "password": "testpass"
     }
     ```

### 3. Test dengan Browser (untuk GET request)

Buka browser dan akses:
- `http://localhost:8000/health`
- `http://localhost:8000/timo/tagihan/123456`

### 4. Bandingkan Response dengan API Lama

#### Cara Manual:
1. Test endpoint di API lama: `http://timo.wipay.id/timo/login`
2. Test endpoint di API baru: `http://localhost:8000/timo/login`
3. Bandingkan response JSON-nya

#### Format Response yang Harus Sama:
```json
{
  "status": 200,
  "pesan": "...",
  "data": {...}
}
```

## Checklist Verifikasi

### ✅ Format Response
- [ ] Status code sama (200, 300, 404)
- [ ] Field `status` ada dan sama
- [ ] Field `pesan` ada dan sama
- [ ] Field `data` ada (jika ada di API lama)
- [ ] Field khusus (seperti `user`, `data_sl`, `wipay`) ada di root level

### ✅ Data Response
- [ ] Struktur data sama
- [ ] Nama field sama
- [ ] Tipe data sama (string, number, array, object)
- [ ] Urutan field (jika penting)

### ✅ Error Handling
- [ ] Error message sama
- [ ] Status code error sama
- [ ] Format error response sama

## Endpoint yang Perlu Di-test

### Authentication
- [ ] `POST /timo/daftar`
- [ ] `POST /timo/login`
- [ ] `POST /timo/login_token`
- [ ] `POST /timo/update_akun`
- [ ] `POST /timo/update_password`

### SL Management
- [ ] `POST /timo/cek_sl`
- [ ] `POST /timo/confirm_sl`
- [ ] `POST /timo/hapus_sl`

### Tagihan
- [ ] `GET /timo/history/{sl}/{periode}`
- [ ] `GET /timo/tagihan/{sl}`

### Pembayaran
- [ ] `POST /timo/request_pembayaran`
- [ ] `POST /timo/cek_pembayaran`
- [ ] `POST /timo/cek_transfer`
- [ ] `POST /timo/batal_pembayaran`
- [ ] `POST /timo/confirm_pembayaran`
- [ ] `POST /timo/history_bayar`

### Laporan
- [ ] `POST /timo/jenis_laporan`
- [ ] `POST /timo/history_gangguan`

### WIPAY
- [ ] `POST /timo/cek_wipay`

### Reset Password
- [ ] `POST /timo/buat_kode`
- [ ] `POST /timo/cek_kode`
- [ ] `POST /timo/reset_kode`

### Upload
- [ ] `POST /timo/upload_catat_meter`
- [ ] `POST /timo/upload_pp`
- [ ] `POST /timo/hapus_pp`
- [ ] `POST /timo/upload_gangguan`
- [ ] `POST /timo/upload_pasang_baru`
- [ ] `POST /timo/upload_bukti_transfer`
- [ ] `POST /timo/upload_baca_mandiri`

### Lainnya
- [ ] `POST /timo/promo`
- [ ] `POST /timo/riwayat_pasang`
- [ ] `POST /timo/jadwal_catat_meter`
- [ ] `POST /timo/request_order_baca_mandiri`

## Tips Testing

1. **Gunakan Data Real**: Test dengan data yang sama di API lama dan baru
2. **Test Error Cases**: Test dengan data invalid, token salah, dll
3. **Test Success Cases**: Test dengan data valid
4. **Bandingkan Side-by-Side**: Buka 2 terminal/window untuk bandingkan response
5. **Gunakan JSON Formatter**: Format JSON response untuk mudah dibaca
6. **Test dengan Aplikasi Mobile**: Jika memungkinkan, test langsung dengan aplikasi mobile

## Tools yang Bisa Digunakan

1. **cURL** - Command line tool
2. **Postman** - GUI tool untuk testing API
3. **Insomnia** - Alternative untuk Postman
4. **HTTPie** - User-friendly command line HTTP client
5. **Browser DevTools** - Untuk test GET request
6. **jq** - Untuk format JSON di terminal: `curl ... | jq`

## Contoh Test Script (Bash)

```bash
#!/bin/bash

BASE_URL="http://localhost:8000"
TOKEN="your_token_here"

echo "Testing Health Check..."
curl -s "$BASE_URL/health"
echo -e "\n\n"

echo "Testing Login..."
curl -s -X POST "$BASE_URL/timo/login" \
  -H "Content-Type: application/json" \
  -d '{"username":"test","password":"test"}' | jq
echo -e "\n\n"

echo "Testing Cek WIPAY..."
curl -s -X POST "$BASE_URL/timo/cek_wipay" \
  -H "Content-Type: application/json" \
  -d "{\"token\":\"$TOKEN\"}" | jq
echo -e "\n\n"
```

## Catatan Penting

1. **Database**: Pastikan database yang digunakan sama dengan API lama
2. **Environment**: Pastikan environment variables sudah benar (.env)
3. **File Upload**: Test upload dengan file real (base64 encoded)
4. **External API**: Pastikan koneksi ke external API (timo.tirtaintan.co.id) berfungsi
5. **CORS**: Pastikan CORS sudah di-enable jika test dari browser

## Troubleshooting

### Response berbeda dengan API lama?
1. Cek format response di `RESPONSE_COMPARISON.md`
2. Cek kode di controller yang sesuai
3. Cek query database apakah sama
4. Cek logic bisnis apakah sama

### Error 500?
1. Cek error log di `logs/` atau PHP error log
2. Cek database connection
3. Cek apakah semua dependency sudah terinstall

### Response kosong?
1. Cek apakah data ada di database
2. Cek query database
3. Cek apakah ada error di log