დოკუმენტაცია

API ვერსია 1.1

ეს დოკუმენტაცია განმარტავს, თუ როგორ უნდა დარეგისტრირდეთ, დააკონფიგურიროთ და განავითაროთ აპლიკაცია, რათა წარმატებით გამოიყენოთ ჩვენი API

აპლიკაციის შექმნა

იმისათვის, რომ თქვენს აპლიკაციას ჰქონდეს წვდომა ჩვენს API-ებზე, თქვე დაარეგისტრიროთ თქვენი განაცხადი" აპლიკაციის ხელსაწყოების პანელი. რეგისტრაცია ქმნის აპლიკაციის ID-ს, რომელიც გვაცნობს ვინ ხართ და გვეხმარება განვასხვავოთ თქვენი აპლიკაცია სხვა აპლიკაციებისგან.

  1. თქვენ მოგიწევთ ახალი აპლიკაციის შექმნა აპლიკაციის შექმნა
  2. განაცხადის შექმნის შემდეგ მიიღებთ app_id და app_secret
შესვლა

შესვლა არის სწრაფი და მოსახერხებელი გზა ხალხისთვის, რათა შექმნან ანგარიშები და შევიდნენ თქვენს აპლიკაციაში. ჩვენი Log in With სისტემა იძლევა ორ სცენარს: ავთენტიფიკაციას და ხალხის მონაცემებზე წვდომის ნებართვების მოთხოვნას. თქვენ შეგიძლიათ გამოიყენოთ სისტემაში შესვლა უბრალოდ ავთენტიფიკაციისთვის ან ავთენტიფიკაციისა და მონაცემების წვდომისთვის..

  1. OAuth შესვლის პროცესის დაწყებისას თქვენ უნდა გამოიყენოთ შემდეგი ბმული:
    <a href="https://twit.ge/api/oauth?app_id=YOUR_APP_ID">Log in With twit.ge</a>

    მომხმარებელი გადამისამართდება შესვლის გვერდზე ასე

  2. მას შემდეგ რაც მომხმარებელი მიიღებს თქვენს აპს, ის გადამისამართდება აპის გადამისამართების URL-ზე auth_key მოსწონს ეს:
    https://mydomain.com/my_redirect_url.php?auth_key=AUTH_KEY
    ეს auth_key მოქმედებს მხოლოდ ერთჯერადი გამოყენებისთვის, ამიტომ მისი გამოყენების შემდეგ ვეღარ შეძლებთ მის ხელახლა გამოყენებას და ახალი კოდის გენერირებას, თქვენ მოგიწევთ მომხმარებლის გადამისამართება შესვლის გვერდზე ბმულის საშუალებით..
Access Token

თქვენი აპის დამტკიცების შემდეგ, შედით ფანჯრის რეჟიმში და დაბრუნდით auth_key ეს ნიშნავს, რომ ახლა მზად ხართ მიიღოთ მონაცემები ჩვენი API-ებიდან და დაიწყოთ ეს პროცესი, თქვენ უნდა დაამტკიცოთ თქვენი განაცხადი და მიიღოთ access_token და თქვენ შეგიძლიათ მიჰყვეთ ჩვენს ნაბიჯებს, რომ იცოდეთ როგორ მიიღოთ იგი.

  1. Access Token მისაღებად, გააკეთეთ HTTP GET მოთხოვნა შემდეგ მისამართზე ასე:
                <?php
                $app_id = "YOUR_APP_ID"; // your app id
                $app_secret = "YOUR_APP_SECRET"; // your app secret
                $auth_key = $_GET['auth_key']; // the returned auth key from previous step
    
                $get = file_get_contents("https://twit.ge/api/authorize?app_id=$app_id&app_secret=$app_secret&auth_key=$auth_key");
    
                $json = json_decode($get, true);
                if(!empty($json['access_token'])) {
                    $access_token = $json['access_token']; // your access token
                }
                ?>                                                                                                
                                
    ეს access_token მოქმედებს მხოლოდ 1 საათის განმავლობაში, ასე რომ, მას შემდეგ რაც ის არასწორი გახდება, მოგიწევთ ახლის გადაწერა, ბმულის საშუალებით მომხმარებლის ხელახლა გადამისამართებით შესვლის გვერდზე.
API-ები

როგორც კი მიიღებთ access_token ახლა თქვენ შეგიძლიათ მიიღოთ ინფორმაცია ჩვენი სისტემიდან HTTP GET მოთხოვნების საშუალებით, რომლებიც მხარს უჭერენ შემდეგ პარამეტრებს

ბოლო წერტილი აღწერა
api/get_user_info

მიიღეთ მომხმარებლის ინფორმაცია

თქვენ შეგიძლიათ მიიღოთ ასეთი მომხმარებლის ინფორმაცია

            if(!empty($json['access_token'])) {
                $access_token = $json['access_token']; // your access token
                $get = file_get_contents("https://twit.ge/api/get_user_info?access_token=$access_token");
            }
                        

შედეგი იქნება:

            {
              "user_info": {
              "user_id": "",
              "user_name": "",
              "user_email": "",
              "user_firstname": "",
              "user_lastname": "",
              "user_gender": "",
              "user_birthdate": "",
              "user_picture": "",
              "user_cover": "",
              "user_registered": "",
              "user_verified": "",
              "user_relationship": "",
              "user_biography": "",
              "user_website": ""
              }
            }