API წვდომა

სტადია I - თოქენის გენერაცია

მას შემდეგ რაც დარეგისტრირდებით ჩვენს პორტალზე, შექმნით კომპანიას და გაივლით ვალიდაციას, Dashboard-ში, მომხმარებლის პროფილის განყოფილებაში, API თოქენებში შექმნით ახალ თოქენს. (გასაღებს მყისვე დააკოპირებთ რადგან მისი ხელმეორედ ნახვა აღარ იქნება შესაძლებელი).

სტადია II - ხელშეკრულებების სია

თქვენი პროგრამიდან ჩვემს პორტალზე გამოაგზავნით GET რექვესთს, რომ წაიღოთ ჩვენს პორტალზე თქვენი კომპანიის ხელშეკრულებების სია, რომელსაც გამოუჩენთ თქვენი პროგრამის მომხმარებელს, რომ აირჩიოს სასურველი ხელშეკრულება შემდეგი სტადიისთვის. (ეს ხელშეკრულების დრაფტები წინასწარ უნდა შექმნათ ჩვენს პორტალზე).

GET რექვესთს მისამართი: https://eauth.ge/api/v1/templates/

Header-ში გადმოცემული პარამეტრები:

• Authorization - Token abcdef1111111111111111111111111111111111
• Content-Type - application/json

(Authorization-ში გადმოეცემა სიტყვა Token, სფეისი და გასაღები დაგენერირებული პირველ სტადიაში).

პროგრამა დაგიბრუნებთ შემდეგი სახის JSON-ს (მასივს იმდენი ხელშეკრულების რამდენიც გაქვთ შექმნილი):

[ 
	{ 
		"template_uuid": "07a13ab0-1809-43bd-ba44-0b21ad9106ee", 
		"template_name": "ხელშეკრულება პირადი ინფორმაციის დამუშავებაზე", 
		"template_tag": null,
		"date_created": "2024-07-20T10:26:22.877949Z"
	}
]
					

სტადია III - კლიენტის და მისი კონტრაქტის შექმნა

თქვენი პროგრამიდან ჩვემს პორტალზე გამოაგზავნით POST რექვესთს, რომ შექმნათ კლიენტი და მისი კონტრაქტი.

კლიენტის მონაცემებთან ერთად ასევე შესაძლებელია გადმოიგზავნოს მისი მეურვის მონაცემები თუ კლიენტი არასრულწლოვანია. "guardian"-ით დაწყებული ველები JSON-ში. (არა აუცილებელი ველები)

ასევე კლიენტის მონაცემებთან ერთად შესაძლებელია გადმოიგზავნოს კომპანიის რომელიმე წარმომადგენლის მონაცემებიც. "comprepr"-ით დაწყებული ველები JSON-ში. (არა აუცილებელი ველები)

POST რექვესთს მისამართი: https://eauth.ge/api/v1/records/

Header-ში გადმოცემული პარამეტრები:

• Authorization - Token abcdef1111111111111111111111111111111111
• Content-Type - application/json

Body-ში გადმოცემული JSON-ი:

{ 
	"first_name": "გიორგი", 
	"last_name": "გიორგაძე", 
	"tel": "+995599000000",  
	"idno": "01000000000",  
	"email": "[email protected]",  
	"template": "07a13ab0-1809-43bd-ba44-0b21ad9106ee",  
	"reference": "4c6b37af-651c-4886-96e1-7f09e3a5d012",  
	"callback_url": "https://example.com/callback",
	"send_mode" : 1,
	"guardian_type": "დედა",
	"guardian_first_name": "ია",
	"guardian_last_name": "ძნელაძე",
	"guardian_id_no": "01100000000",
	"comprepr_type": "მკურნალი ექიმი",
	"comprepr_first_name": "მერაბ",
	"comprepr_last_name": "კაშია",
	"comprepr_id_no": "01200000000"
}
					

idno - პირადი ნომერი; email - იმეილი (არა აუცილებელი ველი); tel - ტელეფონი უნდა იყოს აუცილებლად ამ ფორმატში "+995599000000" "+", ქვეყნის კოდი და შემდეგ ნომერი; template - იმ ხელშეკრულების "template_uuid" რომელსაც აირჩევს მომხმარებელი (დაბრუნებული მეორე სტადიაში); reference - უნიკალური uuid v4, რაზეც გინდათ რომ დაგიბრუნდეთ ხელშეკრულების დადასტურებისას პასუხი (არა აუცილებელი ველი); callback_url - თქვენი ბმული რაზეც გინდათ ავტომატურად მიიღოთ პასუხი, მას შემდეგ რაც კლიენტი დაადასურებს კონტრაქტს (არა აუცილებელი ველი); send_mode - სად გაეგზავნოს კლიენტს კონტრაქტის ბმული: 1 - სმს-ის სახით, 2 - იმეილზე; დეფოლთი არის 1, თუ არ გადმოეცით ჩათვლის როგორც 1-ს (არა აუცილებელი ველი).

პროგრამა დაგიბრუნებთ შემდეგი სახის JSON-ს:

{
	 "reference": "4c6b37af-651c-4886-96e1-7f09e3a5d012",
	 "contract_date": "2024-08-16T10:05:27.200433Z" 
}
					

სტადია IV - კონტრაქტის დადასტურების შემდეგ, ავტომატური პასუხის მიღება

იმ შემთხვევაში თუ თქვენ გადმოაგზავნეთ თქვენი კომპანიის ბმული რაზეც გინდათ ავტუმატური პასუხის მიღება ("callback_url" სტადია III-ში), და გადმოეცით "reference"-ი, თქვენ მიიღებთ პასუხს.

Header-ში გადმოცემული პარამეტრები:

• Content-Type - application/json

პროგრამა POST რექვესთით გადმოგცემთ შემდეგი სახის JSON-ს:

{
	 "reference": "4c6b37af-651c-4886-96e1-7f09e3a5d012", 
	 "approved": 1, 
	 "approve_date": "2024-08-16T10:07:27.200433Z"
}
					

სტადია V - კონტრაქტის სტატუსის შემოწმება

თქვენი პროგრამიდან ჩვემს პორტალზე გამოაგზავნით GET რექვესთს, რომ შეამოწმოთ კლიენტმა დაადასტურა თუ არა ხელშეკრულება.

GET რექვესთს მისამართი: https://eauth.ge/api/v1/records/4c6b37af-651c-4886-96e1-7f09e3a5d012

Header-ში გადმოცემული პარამეტრები:

• Authorization - Token abcdef1111111111111111111111111111111111
• Content-Type - application/json

GET რექვესთს ბოლოში მიდგმული აქვს ხელშეკრულების reference:

პროგრამა დაგიბრუნებთ შემდეგი სახის JSON-ს:

{ 
	 "reference": "4c6b37af-651c-4886-96e1-7f09e3a5d012", 
	 "approved": 1, 
	 "approve_date": "2024-08-16T10:07:27.200433Z",
	 "send_mode" : 1
}
					

დამატებით: დადასტურებული კონტრაქტის გადმოწერა

თქვენი პროგრამიდან ჩვემს პორტალზე გამოაგზავნით GET რექვესთს.

GET რექვესთს მისამართი: https://eauth.ge/api/v1/records/download/4c6b37af-651c-4886-96e1-7f09e3a5d012

Header-ში გადმოცემული პარამეტრები:

• Authorization - Token abcdef1111111111111111111111111111111111
• Content-Type - application/json

GET რექვესთს ბოლოში მიდგმული აქვს ხელშეკრულების reference:

პროგრამა დაგიბრუნებთ ფაილს თუ კონტრაქტი კლიენტის მიერ უკვე დადასტურებულია