# API Out Architecture - External API Calls

## Status: ✅ Semua API Out Sudah di timo.wipay.id_api

Semua external API calls (API out) sekarang sudah di-handle oleh **timo.wipay.id_api** (Slim 4).

## External API yang Dipanggil

### 1. TIMO PDAM API (timo.tirtaintan.co.id)

**Endpoint yang dipanggil:**

- `GET https://timo.tirtaintan.co.id/enquiry/{no_sl}` - Cek tagihan
- `GET https://timo.tirtaintan.co.id/enquiry-dil/{no_sl}` - Cek data pelanggan
- `POST https://timo.tirtaintan.co.id/payment/{token}` - Proses pembayaran
- `POST https://timo.tirtaintan.co.id/push-registrasi` - Registrasi pasang baru

**Digunakan di:**

- `FastController::checkBill()` - Cek tagihan
- `FastController::processPayment()` - Proses pembayaran
- `SLController::cekSL()` - Cek data SL
- `SLController::confirmSL()` - Konfirmasi SL
- `UploadController::uploadPasangBaru()` - Registrasi pasang baru

### 2. Rasamala API (rasamala.tirtaintan.co.id)

**Endpoint yang dipanggil:**

- `POST https://rasamala.tirtaintan.co.id/timo/upload-cater/{wrute_id}` - Upload baca mandiri

**Digunakan di:**

- `UploadController::uploadBacaMandiri()` - Upload baca mandiri

### 3. BRI API (untuk verifikasi pembayaran)

**Endpoint yang dipanggil:**

- `POST {BRI_URL_TOKEN}` - Get BRI token
- `POST {BRI_URL_MUTASI}` - Get mutasi rekening

**Digunakan di:**

- `SiteController::verifyBri()` - Verifikasi pembayaran BRI
- `SiteController::getBriToken()` - Get BRI token
- `SiteController::getMutasi()` - Get mutasi BRI

### 4. WhatsApp API (opsional)

**Digunakan di:**

- `SiteController::sendPaymentNotification()` - Kirim notifikasi WhatsApp

## Helper Class

### HttpHelper

Semua external API calls menggunakan `App\Helpers\HttpHelper::doCurl()`

**Location:** `src/Helpers/HttpHelper.php`

**Method:**

```php
HttpHelper::doCurl($url, $method = 'GET', $data = null, $json = false, $headers = [])
```

**Features:**

- Support GET dan POST
- Support JSON dan form data
- Error handling
- SSL verification (disabled untuk development)
- Timeout handling

## Arsitektur

```
timo.wipay.id_api (Slim 4)
├── Controllers
│   ├── FastController
│   │   └── checkBill() → HttpHelper → timo.tirtaintan.co.id
│   ├── SLController
│   │   └── cekSL() → HttpHelper → timo.tirtaintan.co.id
│   ├── UploadController
│   │   └── uploadBacaMandiri() → HttpHelper → rasamala.tirtaintan.co.id
│   └── SiteController
│       └── verifyBri() → HttpHelper → BRI API
└── Helpers
    └── HttpHelper
        └── doCurl() → cURL → External APIs
```

## Keuntungan

1. **Centralized**: Semua API out di satu tempat (timo.wipay.id_api)
2. **Consistent**: Semua menggunakan HttpHelper yang sama
3. **Maintainable**: Mudah di-maintain dan di-debug
4. **Testable**: Bisa di-mock untuk testing
5. **Error Handling**: Error handling yang konsisten

## Backend (timo.wipay.id) - CodeIgniter

**Status:** Backend CodeIgniter **TIDAK** lagi mengurus API out

Backend CodeIgniter sekarang hanya:

- Admin panel (jika masih digunakan)
- View/UI (jika masih digunakan)
- Database management (jika masih digunakan)

**Semua API out sudah pindah ke timo.wipay.id_api**

## Rekomendasi

### Option 1: Full Migration (Recommended)

✅ **Semua API out di timo.wipay.id_api**

- Semua external API calls dari Slim 4
- Backend CodeIgniter hanya untuk admin panel (jika masih dipakai)
- Atau bisa di-decommission jika tidak dipakai lagi

### Option 2: Hybrid

⚠️ **Tidak direkomendasikan**

- API out di dua tempat (Slim 4 dan CodeIgniter)
- Bisa menyebabkan duplikasi dan konflik
- Sulit di-maintain

## Kesimpulan

✅ **timo.wipay.id_api (Slim 4) yang mengurus semua API out**

Backend CodeIgniter (timo.wipay.id) tidak lagi mengurus API out, semua sudah pindah ke Slim 4.

## Next Steps

1. ✅ Semua API out sudah di timo.wipay.id_api
2. ⚠️ Pastikan tidak ada API out yang masih di CodeIgniter
3. ⚠️ Test semua external API calls
4. ⚠️ Monitor error logs untuk external API calls
5. ⚠️ Setup retry mechanism jika diperlukan
6. ⚠️ Setup rate limiting jika diperlukan