{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"41ed4fa6-9124-46dc-8e53-71afe0da2987","name":"Dijital İmza Platformu API","description":"## Genel Tanıtım\n\n\n\nDİP panelini kullanmadan entegrasyonla imza süreci başlatmak ve imza almak için zengin özellikleri olan bir API mevcuttur. API'deki endpoint'lerin nasıl kullanılacağına dair detaylı bilgiyi bu dokümanda bulabilirsiniz. Endpoint'lerin listesi soldaki menüde mevcuttur. Request'lerde göreceğiniz UID ve token'lar temsilidir; kendi bilgilerinizle kullanıyor olmalısınız.\n\n## Videolu İçerikler\n\n\n\n\n\n\n\n\n\n## Bulut Erişimi\n\nEğer DİP'i onprem değil de doğrudan bulut üzerinden kullanıyorsanız (buluttan kullanmanız önerilir) gerekli erişim bilgileri aşağıdaki gibidir:\n\nBulut API Adresi: `https://www.dijitalimza.com.tr/api...`\n\nBulut IP Adresi: `193.35.205.196`\n\nBulut port: `443` (HTTP)\n\nEğer webhook kullanıyorsanız, DİP'in webhook'unuzun çalıştığı uygulama sunucunuza erişebilmesi gerekir. Eğer kısıtlama varsa firewall'unuzda bulut IP'ye erişim yetkisi vermeniz gerekir. Benzer şekilde, uygulama sunucunuzdan DİP Bulut API'ye bağlanıyorsanız, porta erişim vermeniz gerekir.\n\n## Hızlı Başlangıç\n\nÇok genel hatlarıyla tipik bir API imza süreci şu şekilde gerçekleşir:\n\n1. Authorization: Bearer token alınır\n2. Create Document: PDF'in kendisini göndererek veya DİP'te tanımlı bir şablona verileri doldurarak dokümanı oluşturursunuz. Bunu yaptığınızda artık 3 farklı yöntemle imza almaya başlayabilirsiniz:\n 1. Inframe yöntemiyle direkt imza arayüzünü açma: Bu yolla imzacılar hiç DİP paneline geçiş yapmadan direkt mevzut yazılımınızın içinden imza atabilir. Inframe URL deseni: \n **`https://dijitalimza.com.tr/inframe/{documentId}/{recipientId}`**\n 2. Tabletten biyometrik imza alma (Kodla Erişim): Eğer alıcıya Access Code (TC No, Pasaport No, Personel No, bordro no vs) belirttiyseniz, imzacılar tabletteki Kodla Erişim moduyla Access Code girip imza atabilirler.\n 3. Tabletten biyometrik imza alma (KIOSK): Menüden \"Send to KIOSK with Recipient\" seçerek daha detaylı bilgiye ulaşabilirsiniz.\n 4. E-posta veya SMS'teki linkle tıklayarak: İmzacılar kendilerine gelen linke tıklayıp imza atabilirler. Send edilmiş bir doküman alıcılara SMS/e-posta ile gönderilir.\n3. Send: Kullanımı şart değildir. Eğer alıcılara e-posta veya SMS ile gönderilmesini istiyorsanız çağırabilirsiniz.\n4. Arşivleme: İmza süreci tamamlanan dokümanlar el değmeden DİP tarafından otomatik olarak bir FTP, S3 veya webhook adresinize gönderilebilir. DİP panelindeki Hesap Ayarları bölümünde ilgili ayarları bulabilirsiniz. Bir dokümanın/zarfın durum bilgisini Get endpoint'i ile çekebilirsiniz.\n \n\n## Kullanıcı Rolleri\n\nDİP panelinde ve mobil uygulamasında rollerin etkisi yüksektir. Bir kullanıcıya rol eklemek için kullanılabilecek UID'ler aşağıdaki gibidir:\n\n- Temel (Herkeste olmalı. Varsayılan herkese eklenir.): 28cc1d6c-8ddd-47a5-b45b-939795295abc\n- Kurum Kullanıcısı (tabletteki gösterge paneli için): 20647b3d-dddc-40ef-a59f-d4dac18b24a7\n- KIOSK (Tabletteki bekleme modu için): 39ed48e1-f267-4727-a280-269cb2163c01\n- Hesap Yöneticisi (Kuruma yeki kullanıcıyı ekleyip kaldıracak en üst yetkili kişiye atanan rol): b46909bb-8c1d-47a2-8512-8a4281d5786c\n- Taslaklar (Tabletteki taslak özelliği için): be685b38-4d7d-42bb-933d-d62979078e63\n \n\n## İmza Yöntemleri\n\nYasal geçerliliği olan tüm yöntemlerle imzalama yapılabilmektedir. DİP ekranları iyi bir kullanıcı deneyimi sunar. İmzacıya hangi yöntemle imzalamak istediği sorulur. Gönderici tarafından belirlenen yöntemlerden istediğini seçerek imza atar.\n\n1. 2D imza: Parmakla atılan imza. AB ve Amerika'da yasal geçerliliği vardır. Türkiye'de yasal geçerliliği olmadığından genelde kurum içi süreçlerde kullanılır.\n2. Biyometrik imza: Özel ekranlı tablet ve telefonlarda özel kalemle atılan imza.\n3. Mobil imza: Tüm operatörleri destekler. Kullanıcı telefonuna operatörden gelen özel bildirimle PIN girerek imza atar.\n4. E-imza (elektronik imza): Bilgisayara USB dongle/token takılarak atılan imza. Bilgisayara özel bir yazılım kurulur. İndirilecek yazılımı kullanıcı ekrandaki linki tıklayarak indirir. Kullanıcı öncesinde e-imza cihazını satın aldığı firmanın kendi yazılımını kurmalıdır.\n5. TC Kimlik Kartıyla imza: Tuş takımı olan pinpad cihaza TCKK yerleştirilir. PIN girilerek imza atılır. Yalnızca DİP Mobile içinde kullanılabilir.\n \n\n## Destek\n\nSize bir hesap açılması için, PoC talebi, demo, developer destek veya video call ile destek talepleriniz için bizimle iletişime geçebilirsiniz :)\n\n[destek@ddtech.com.tr](https://)","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"27114402","collectionId":"41ed4fa6-9124-46dc-8e53-71afe0da2987","publishedId":"2s946cetAb","public":true,"publicUrl":"https://documenter-api.postman.tech/view/27114402/2s946cetAb","privateUrl":"https://go.postman.co/documentation/27114402-41ed4fa6-9124-46dc-8e53-71afe0da2987","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":""}],"appearance":{"default":"light","themes":[{"name":"dark","logo":"https://content.pstmn.io/815aa81c-28b4-4237-a315-8ebfc54bf961/ZG93bmxvYWQucG5n","colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":"https://content.pstmn.io/815aa81c-28b4-4237-a315-8ebfc54bf961/ZG93bmxvYWQucG5n","colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.10.1","publishDate":"2023-12-22T09:23:43.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":""},"logos":{"logoLight":"https://content.pstmn.io/815aa81c-28b4-4237-a315-8ebfc54bf961/ZG93bmxvYWQucG5n","logoDark":"https://content.pstmn.io/815aa81c-28b4-4237-a315-8ebfc54bf961/ZG93bmxvYWQucG5n"}},"statusCode":200},"environments":[],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/768118b36f06c94b0306958b980558e6915839447e859fe16906e29d683976f0","favicon":""},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"}],"canonicalUrl":"https://documenter.gw.postman.com/view/metadata/2s946cetAb"}