# 📘 Mikro Desktop API – Kurulum ve Port Ayarları (Görselli Anlatım)

Bu döküman, Mikro ERP sisteminde kullanılan **Mikro Desktop API** servisinin kurulumu, servis kontrolü ve port değişikliği işlemlerini adım adım açıklamaktadır.

## 🟢 1. Kurulum Kaynağı

- Kurulum dosyası [Mikro Sürüm Güncellemeleri](https://www.mikro.com.tr/surum-guncellemeleri-v17/#fly) sayfasından temin edilir.
- **"Server"** kutucuğu seçilerek ilgili setup dosyası indirilmelidir.
- İndirilen Setup dosyası kurulduktan sonra servis kontrolü sağlanır.


**![Sürüm Güncellemeleri]**

img
## 🛠️ 2. Kurulum Sonrası Servis Kontrolü

- Kurulumdan sonra `services.msc` içerisinde **Mikro Desktop API** servisi otomatik olarak başlatılır.
- Servis adı: `Mikro Desktop API`
- Başlangıç türü: **Otomatik**
- Servis Oturum Kullanıcısı: `NT SERVICE\MikroDesktopAPIContainer`


**![Windows Hizmetler - Mikro Desktop API]**



## 🌐 3. Varsayılan Port Bilgisi

- Servis varsayılan olarak `8094` portunu kullanır.
- API'ye şu şekilde istek yapılabilir:



```http
POST http://localhost:8094/Api/APIMethods/APILogin
Content-Type: application/json
```

## 🧭 4. Port Bilgisini Regedit Üzerinden Görüntüleme

- Kayıt defteri yoluna gidin:



```
Bilgisayar\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\MikroDesktopAPIContainer\Parameters
```

- Burada `Port` anahtarının değeri `8094` olarak girilmiştir.


**![Regedit Port Ayarı]**

img
## 🔄 5. Port Değiştirme Adımları

1. `services.msc` üzerinden **Mikro Desktop API** servisini durdurun.
2. `regedit` aracılığıyla `Port` değerini açın.
3. Taban seçeneğini `Ondalık` olarak ayarlayın ve istediğiniz port numarasını girin (örn. 9090).
4. Değişikliği kaydedip servisi tekrar başlatın.


⚠️ Not: Yeni port için **Windows Güvenlik Duvarı** üzerinden izin verildiğinden emin olun.

## ✅ 6. Test

Bütün aşamaların kontrolü ve düzenlemeleri sağlandıktan sonra Postman ile endpoint üzerinden API çalışıyor mu kontrol edebilirsiniz:


```http
POST http://localhost:8094/Api/APIMethods/APILogin
```



## 📎 Ek Bilgi

- API yanıtları JSON formatındadır ve oturum açmak için `APILogin` metodu kullanılabilir.
- API Login Endpointi V1 methodları için geçerlidir. V2 ve V3 methodları için Her endpoint içerisinde jsonda Kullanıcı bilgileri post edilerek kullanım sağlanır. İşlemler bittiğinde endpoint sizi log out edecektir.