{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["img"]},"type":"markdown"},"seo":{"title":"MikroJB-API Login Entegrasyon ve Kullanım Dokümanı","description":"Mikro Yazılım geliştiricileri için hazırlanmış API dokümantasyon sayfası.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"mikrojb-api-login-entegrasyon-ve-kullanım-dokümanı","__idx":0},"children":["MikroJB-API Login Entegrasyon ve Kullanım Dokümanı"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Bu doküman, ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MikroAPI (Genel)"]}," servisleri üzerinden ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["APILogin"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MikroApiUp"]}," kimlik doğrulama isteklerinde ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"1-i̇stek-mimarisi-ve-analizi","__idx":1},"children":["1. İstek Mimarisi ve Analizi"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["MikroAPI login mimarisi, hem ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["HTTP Header (Bearer Token)"]}," seviyesinde hem de ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["JSON Request Body"]}," seviyesinde çift katmanlı bir doğrulama yapısı kullanır."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"endpoint-detayları","__idx":2},"children":["Endpoint Detayları"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["HTTP Metodu:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["URL Yapısı:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{{ApiLinkV16Gateway}}/ApiMethods/{{LoginAlias}}/APILogin"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ApiLinkV16Gateway"]},": MikroAPI servisinin çalıştığı gateway adresi (örn. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://jumpbulutapigw.mikro.com.tr/ApiJB/ApiMethods"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LoginAlias"]},": Firma/API için tanımlanmış servis takma adı (MIKRO-1234)."]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"2-http-header-gereksinimleri","__idx":3},"children":["2. HTTP Header Gereksinimleri"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Başarılı bir oturum açma isteği için aşağıdaki HTTP başlıklarının gönderilmesi şarttır:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Header"},"children":["Header"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Değer / Format"},"children":["Değer / Format"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Açıklama"},"children":["Açıklama"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Content-Type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["application/json"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Gönderilen verinin JSON formatında olduğunu belirtir."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Bearer {{KeyToken}}"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["MikroAPI Gateway seviyesinde yetkilendirme sağlayan Bearer Token."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["User-Agent"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MkRo4486JB76043"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Request'in MikroAPI istemcisi üzerinden gönderildiğini belirtir. Tüm requestlerde bu değer kullanılmalıdır."]}]}]}]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Önemli:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["KeyToken"]}," değeri geçersiz, süresi dolmuş veya hatalı olduğunda API gateway seviyesinde ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["401 Unauthorized"]}," veya ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["403 Forbidden"]}," hatası alınır."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"3-i̇stek-gövdesi-request-body","__idx":4},"children":["3. İstek Gövdesi (Request Body)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["İstek gövdesi ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["application/json"]}," formatında olmalı ve Mikro v16 veritabanı/oturum parametrelerini içermelidir."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"json-şablonu","__idx":5},"children":["JSON Şablonu"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"Alias\": \"{{LoginAlias}}\",\n  \"FirmaKodu\": \"{{LoginFirmaKodu}}\",\n  \"CalismaYili\": \"{{LoginCalismaYili}}\",\n  \"ApiKey\": \"{{LoginApiKey}}\",\n  \"KullaniciKodu\": \"{{LoginKullaniciKoduSRV}}\",\n  \"Sifre\": \"{{LoginSifreSRV}}\",\n  \"FirmaNo\": \"{{LoginFirmaNo}}\",\n  \"SubeNo\": \"{{LoginSubeNo}}\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"parametre-açıklamaları-ve-veri-tipleri","__idx":6},"children":["Parametre Açıklamaları ve Veri Tipleri"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Parametre"},"children":["Parametre"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Tipi"},"children":["Tipi"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Örnek Değer"},"children":["Örnek Değer"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"center","data-label":"Zorunlu mu?"},"children":["Zorunlu mu?"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Açıklama"},"children":["Açıklama"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Alias"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["String"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"DEMO_ALIAS\""]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Evet"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["URL path ile eşleşmesi gereken firma alias adı."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FirmaKodu"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["String"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"MIKRO_DEMO\""]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Evet"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Mikro v16 veritabanı firma kodu."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CalismaYili"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["String/Int"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"2026\""]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Evet"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["İşlem yapılacak aktif çalışma yılı."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ApiKey"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["String"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"abc123xyz...\""]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Evet"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["MikroAPI entegrasyonu için tanımlanmış API anahtarı."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["KullaniciKodu"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["String"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"SRV\""]}," veya ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"1\""]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Evet"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Mikro v16 yetkili kullanıcı kodu."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sifre"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["String"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"MD5_HASH--GUNUNTARIHI_VE_PAROLA\""]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Evet"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Kullanıcı şifresi (Mikro yapılandırmasına göre MD5 hash)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FirmaNo"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Integer"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Evet"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Çalışılacak firma sıra numarası (Varsayılan: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0"]},")."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SubeNo"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Integer"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"center"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Evet"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Çalışılacak şube sıra numarası (Varsayılan: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0"]},")."]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"4-http-200-ok-almak-i̇çin-adım-adım-kontrol-listesi","__idx":7},"children":["4. HTTP 200 OK Almak İçin Adım Adım Kontrol Listesi"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Gateway URL & Alias Kontrolü:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{{ApiLinkV16Gateway}}"]}," adresinin erişilebilir ve aktif olduğundan emin olun."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Path içerisindeki ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{{LoginAlias}}"]}," ile body içerisindeki ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"Alias\""]}," alanının birebir aynı string değerini taşıdığını doğrulayın."]}]}]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/image-copy.b9bedc555c9da811a18e72594237ed1a47bc26d9f0700c4b6782586fb3939248.9c1bb791.png","alt":"image copy.png","framed":false,"withLightbox":true,"width":"","height":""},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":2},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Bearer Token Doğrulaması:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Header alanına ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization: Bearer <KeyToken>"]}," parametresinin eksiksiz eklendiğinden emin olun."]}]}]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/image.c08b86dae355083ca4d40d059c6b8449631f1947f8d6633f8e39d6d70b78897f.9c1bb791.png","alt":"image.png","framed":false,"withLightbox":true,"width":"","height":""},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":3},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["TOKEN Endpointi."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Body alanında bulunan Username ve Password alanına Mikro IDM kullanıcı bilgileri ile giriş yapılarak Send Edilir ve Token üretilir."]}]}]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/image-copy-2.d3a9c6a8516ac861184b69d91d5ba7710fb9ea45ef4bfb96408ea14118e1edb6.9c1bb791.png","alt":"image copy 2.png","framed":false,"withLightbox":true,"width":"","height":""},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":4},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["User-Agent Header Key eklentisi"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Gelen istekler için Headers'da User-Agent Eklenmelidir. ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Key : ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["User-Agent"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Value : ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MkRo4486JB76043"]}]}]}]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/image-copy-3.8deaca756f8844ce80f9cf9c52f20e2a523224a475bbd3619568346db4c083c1.9c1bb791.png","alt":"image copy 3.png","framed":false,"withLightbox":true,"width":"","height":""},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":5},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Mikro Veritabanı ve Kullanıcı Yetkileri:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FirmaKodu"]}," ve ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CalismaYili"]}," Mikro ERP sisteminde tanımlı ve erişilebilir durumda olmalıdır."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["KullaniciKodu"]}," servise erişim yetkisine sahip aktif bir SRV veya sistem kullanıcısı olmalıdır."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sifre"]}," alanı MikroAPI'nin beklediği formatta (MD5 hash- Gününtarihi Boşluk Şifre - örn. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0496d62c59cccbb4894dadf4fdebc5e8"]}," gibi MD5 değeri) doğru iletilmelidir. ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Karakter ve Format Kontrolü:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Body verisinin geçerli bir JSON objesi olduğundan, kaçış karakterlerinin (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\\r\\n"]},") veya tırnak hatalarının JSON yapısını bozmadığından emin olun."]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"5-örnek-kod-kullanımları","__idx":8},"children":["5. Örnek Kod Kullanımları"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"curl","__idx":9},"children":["cURL"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl --location --request POST 'https://jumpbulutapigw.mikro.com.tr/ApiJB/ApiMethods/DEMO_ALIAS/APILogin' \\\n--header 'Content-Type: application/json' \\\n--header 'Authorization: Bearer YOUR_KEY_TOKEN_HERE' \\\n--header 'User-Agent: MkRo4486JB76043' \\\n--data-raw '{\n  \"Alias\": \"DEMO_ALIAS\",\n  \"FirmaKodu\": \"DEMO_FIRMA\",\n  \"CalismaYili\": \"2026\",\n  \"ApiKey\": \"YOUR_API_KEY\",\n  \"KullaniciKodu\": \"1\",\n  \"Sifre\": \"0496d62c59cccbb4894dadf4fdebc5e8\",\n  \"FirmaNo\": \"0\",\n  \"SubeNo\": \"0\"\n}'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"python--requests-","__idx":10},"children":["Python (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requests"]},")"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"python","header":{"controls":{"copy":{}}},"source":"import requests\nimport json\n\nurl = \"https://jumpbulutapigw.mikro.com.tr/ApiJB/ApiMethods/DEMO_ALIAS/APILogin\"\n\npayload = json.dumps({\n    \"Alias\": \"DEMO_ALIAS\",\n    \"FirmaKodu\": \"DEMO_FIRMA\",\n    \"CalismaYili\": \"2026\",\n    \"ApiKey\": \"YOUR_API_KEY\",\n    \"KullaniciKodu\": \"1\",\n    \"Sifre\": \"0496d62c59cccbb4894dadf4fdebc5e8\",\n    \"FirmaNo\": 0,\n    \"SubeNo\": 0\n})\n\nheaders = {\n    'Content-Type': 'application/json',\n    'Authorization': 'Bearer YOUR_KEY_TOKEN_HERE'\n    'User-Agent: MkRo4486JB76043'\n}\n\nresponse = requests.request(\"POST\", url, headers=headers, data=payload)\n\nprint(response.status_code)\nprint(response.text)\n","lang":"python"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"6-olası-hata-durumları-ve-çözümleri","__idx":11},"children":["6. Olası Hata Durumları ve Çözümleri"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"HTTP Kodu / Durum"},"children":["HTTP Kodu / Durum"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Olası Neden"},"children":["Olası Neden"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Çözüm"},"children":["Çözüm"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["401 Unauthorized"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Bearer Token (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["KeyToken"]},") eksik veya geçersiz."]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Header alanındaki Bearer Token bilgisini yenileyin."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["404 Not Found"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["URL üzerindeki ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LoginAlias"]}," veya Endpoint adı hatalı."]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["URL yolunu ve Alias parametresini kontrol edin."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["400 Bad Request"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Request Body JSON formatı bozuk veya eksik alan var."]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Gönderilen JSON verisini doğrulayın."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["500 Internal Error"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Firma Kodu, Çalışma Yılı, Kullanıcı Kodu/Şifre veya DB bağlantısı hatalı."]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Mikro ERP veritabanı servislerinin çalışırlığını ve kullanıcı kimlik bilgilerini doğrulayın."]}]}]}]}]}]},"headings":[{"value":"MikroJB-API Login Entegrasyon ve Kullanım Dokümanı","id":"mikrojb-api-login-entegrasyon-ve-kullanım-dokümanı","depth":1},{"value":"1. İstek Mimarisi ve Analizi","id":"1-i̇stek-mimarisi-ve-analizi","depth":2},{"value":"Endpoint Detayları","id":"endpoint-detayları","depth":3},{"value":"2. HTTP Header Gereksinimleri","id":"2-http-header-gereksinimleri","depth":2},{"value":"3. İstek Gövdesi (Request Body)","id":"3-i̇stek-gövdesi-request-body","depth":2},{"value":"JSON Şablonu","id":"json-şablonu","depth":3},{"value":"Parametre Açıklamaları ve Veri Tipleri","id":"parametre-açıklamaları-ve-veri-tipleri","depth":3},{"value":"4. HTTP 200 OK Almak İçin Adım Adım Kontrol Listesi","id":"4-http-200-ok-almak-i̇çin-adım-adım-kontrol-listesi","depth":2},{"value":"5. Örnek Kod Kullanımları","id":"5-örnek-kod-kullanımları","depth":2},{"value":"cURL","id":"curl","depth":3},{"value":"Python ( requests )","id":"python--requests-","depth":3},{"value":"6. Olası Hata Durumları ve Çözümleri","id":"6-olası-hata-durumları-ve-çözümleri","depth":2}],"frontmatter":{"seo":{"title":"MikroJB-API Login Entegrasyon ve Kullanım Dokümanı"}},"lastModified":"2026-08-12T09:50:49.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/jbapi","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}