API Version 1.1

Այս փաստաթղթում նշվում է՝ ինչպես կարող եք գրանցվել, կարգավորել եւ մշակել Ձեր հավելվածը եւ հաջողությամբ օգտագործել մեր հավելվածի ծրագրային միջերեսը

Ստեղծել հավելված

Որպեսի հավելվածը հաջողությամբ հասանելի լինի մեր ՀԾԻ-ն Դուք պետք է գրանցվեք Հավելվածի վահանակ. Գրանցումից հետո ստեղծվում է հավելվածի ID, որը հնարավորություն է տալիս ճանաչելու թե ով եք Դուք եւ հնարվոր է դառնում տարբերել Ձեր հավելվածը մյուսներից.

1. Անհրաժեշտ է նոր հավելված ստեղծել Ստեղծել նոր հավելված
2. Հավելվածը ստեղծելուց հետո կստաանք Ձեր app_id եւ app_secret

Մուտք գործել

Համակարգով մուտք գործելը հարմար եւ արագ է հաշիվներ ստեղծելու եւ Ձեր հավելված մուտք գործելու համար: Մեր «Համակարգի միջոցով մուտքը» հնարավոր է դարձնում երկու իրավիճակ, նույնականացմամբ եւ մարդկանց տվյալներին հասանելիություն ունենալու միջոցով․Կարող եք կիրառել Համակարգով մուտք գործելը նույնականացմամբ կամ տվյալներին հասանելիություն ունենալու միջոցով.

1. OAuth մուտքի գործընթացը սկսելու համար անհրաժեշտ է անցնելհետեւյալ հղումով:

   <a href="https://mitani.am/api/oauth?app_id=YOUR_APP_ID">Log in With Mitani.am</a>

   Օգտատերը կստանա նմանատիպ հղում էջ մուտք գործելու համար

   
2. Երբ օգտատերն ընդունի ձեր հավելվածը, նա կվերահասցվորվի Ձեր հավելվածվերահասցեվորել URL֊ը auth_key Հավանել:

   https://mydomain.com/my_redirect_url.php?auth_key=AUTH_KEY

   Սա auth_key Վավեր է միայն մեկանգամյա օգտագործման համար, եթե նախկինում օգտագործել եք, չեք կարողանակրկին օգտագործել ստեղծեք նոր կոդ և օգտատիրոջը հղում ուղարկեքորպեսզի կարողանա կրկին մուտք գործել համակարգ.

Մուտքի հետքանշիչ

Երբ ստանաք գտատիրոջ հաստատում ձեր՝ «Պատուհանով մուտք» հավելվածի համար եւ վերադարձնեք դեպի էջ auth_key որը նշանակում է, որ Դուք այժմ պատրաստ եք ստանալ տվյալներ մեր ԱԾՓ֊ից (API)․ Դրա համար հարկավոր է վավերացնել Ձեր հավելվածը եւ ստանալ access_token կարող եք հետեւել հրահանգներին եւ հասկանալ, թե ինչպես կարող եք հասանելիություն ստանալ.

1. Մուտքի հասանելիություն ստանալու համար հարցում ուղարկեք հետեւյալ վերջնակետին 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://mitani.am/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 վավեր է միայն մեկ ժամ, երբ կրկին անվավեր կլինի օգտատերը կստանա նոր հղումկրկին համակարգ մուտք գործելու համար.

API-միջերես

Երբ ստանաք ձեր access_token Այժմ Դուք կարող եք տեղեկություն ստանալ մեր համակարգից HTTP GET հարցում ուղարկելու միջոցով որը հնարավոր է դառնում հետեւյալ երկու հարաչափերի միջոցով

Օգտատիրոջ մասին կարող եք այսպես տեղեկություն ստանալ

if(!empty($json['access_token'])) {
   $access_token = $json['access_token']; // your access token
   $get = file_get_contents("https://mitani.am/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": ""
    }
}