MikroJB-API Login Entegrasyon ve Kullanım Dokümanı

Bu doküman, MikroAPI (Genel) servisleri üzerinden APILogin / MikroApiUp kimlik doğrulama isteklerinde HTTP 200 OK yanıtı alabilmeniz için gerekli teknik analizleri, istek yapısını, zorunlu parametreleri ve kontrol noktalarını içermektedir. Örnek POSTMAN Collection'a Anasayfa üzerinde bulunan ekstra kaynaklar bölümünden erişilebilir.

MikroAPI login mimarisi, hem HTTP Header (Bearer Token) seviyesinde hem de JSON Request Body seviyesinde çift katmanlı bir doğrulama yapısı kullanır.

• HTTP Metodu: POST
• URL Yapısı: {{ApiLinkV16Gateway}}/ApiMethods/{{LoginAlias}}/APILogin
  • ApiLinkV16Gateway: MikroAPI servisinin çalıştığı gateway adresi (örn. https://jumpbulutapigw.mikro.com.tr/ApiJB/ApiMethods).
  • LoginAlias: Firma/API için tanımlanmış servis takma adı (MIKRO-1234).

Başarılı bir oturum açma isteği için aşağıdaki HTTP başlıklarının gönderilmesi şarttır:

Önemli: KeyToken değeri geçersiz, süresi dolmuş veya hatalı olduğunda API gateway seviyesinde 401 Unauthorized veya 403 Forbidden hatası alınır.

İstek gövdesi application/json formatında olmalı ve Mikro v16 veritabanı/oturum parametrelerini içermelidir.

{
  "Alias": "{{LoginAlias}}",
  "FirmaKodu": "{{LoginFirmaKodu}}",
  "CalismaYili": "{{LoginCalismaYili}}",
  "ApiKey": "{{LoginApiKey}}",
  "KullaniciKodu": "{{LoginKullaniciKoduSRV}}",
  "Sifre": "{{LoginSifreSRV}}",
  "FirmaNo": "{{LoginFirmaNo}}",
  "SubeNo": "{{LoginSubeNo}}"
}

1. Gateway URL & Alias Kontrolü:
   • {{ApiLinkV16Gateway}} adresinin erişilebilir ve aktif olduğundan emin olun.
   • Path içerisindeki {{LoginAlias}} ile body içerisindeki "Alias" alanının birebir aynı string değerini taşıdığını doğrulayın.

2. Bearer Token Doğrulaması:
   • Header alanına Authorization: Bearer <KeyToken> parametresinin eksiksiz eklendiğinden emin olun.

3. TOKEN Endpointi.
   • Body alanında bulunan Username ve Password alanına Mikro IDM kullanıcı bilgileri ile giriş yapılarak Send Edilir ve Token üretilir.

4. User-Agent Header Key eklentisi
   • Gelen istekler için Headers'da User-Agent Eklenmelidir.
     
   • Key : User-Agent
   • Value : MkRo4486JB76043

5. Mikro Veritabanı ve Kullanıcı Yetkileri:
   • FirmaKodu ve CalismaYili Mikro ERP sisteminde tanımlı ve erişilebilir durumda olmalıdır.
   • KullaniciKodu servise erişim yetkisine sahip aktif bir SRV veya sistem kullanıcısı olmalıdır.
   • Sifre alanı MikroAPI'nin beklediği formatta (MD5 hash- Gününtarihi Boşluk Şifre - örn. 0496d62c59cccbb4894dadf4fdebc5e8 gibi MD5 değeri) doğru iletilmelidir.
     
     
6. Karakter ve Format Kontrolü:
   • Body verisinin geçerli bir JSON objesi olduğundan, kaçış karakterlerinin (\r\n) veya tırnak hatalarının JSON yapısını bozmadığından emin olun.

curl --location --request POST 'https://jumpbulutapigw.mikro.com.tr/ApiJB/ApiMethods/DEMO_ALIAS/APILogin' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_KEY_TOKEN_HERE' \
--header 'User-Agent: MkRo4486JB76043' \
--data-raw '{
  "Alias": "DEMO_ALIAS",
  "FirmaKodu": "DEMO_FIRMA",
  "CalismaYili": "2026",
  "ApiKey": "YOUR_API_KEY",
  "KullaniciKodu": "1",
  "Sifre": "0496d62c59cccbb4894dadf4fdebc5e8",
  "FirmaNo": "0",
  "SubeNo": "0"
}'

import requests
import json

url = "https://jumpbulutapigw.mikro.com.tr/ApiJB/ApiMethods/DEMO_ALIAS/APILogin"

payload = json.dumps({
    "Alias": "DEMO_ALIAS",
    "FirmaKodu": "DEMO_FIRMA",
    "CalismaYili": "2026",
    "ApiKey": "YOUR_API_KEY",
    "KullaniciKodu": "1",
    "Sifre": "0496d62c59cccbb4894dadf4fdebc5e8",
    "FirmaNo": 0,
    "SubeNo": 0
})

headers = {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_KEY_TOKEN_HERE'
    'User-Agent: MkRo4486JB76043'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.status_code)
print(response.text)