Версия API 1.1

В этой документации объясняется, как зарегистрировать, настроить и разработать ваше приложение для успешного использования наших API.

Создать приложение

Чтобы ваше приложение могло обращаться к нашим API, необходимо зарегистрировать его с помощью Панель инструментов приложения. Регистрация создаёт ID приложения, который помогает нам идентифицировать вас и отличать ваше приложение от других..

1. Вам нужно будет создать новое приложение Создание нового приложения
2. Как только вы создали приложение вы получите app_id и app_secret

Войти в с

Система «Войти через» — быстрый и удобный способ для пользователей создавать аккаунты и входить в ваше приложение. Наша система поддерживает два сценария: аутентификацию и запрос разрешений на доступ к данным пользователя. Вы можете использовать её только для аутентификации или для аутентификации и доступа к данным..

1. Для начала процесса входа через OAuth используйте ссылку для вашего приложения, например::

   <a href="https://kastinginfo.com/api/oauth?app_id=YOUR_APP_ID">Log in With KastingInfo – International Casting Platform for Models, Actors & Talent</a>

   Пользователь будет перенаправлен на страницу входа в систему, как это

   
2. После того как пользователь одобрит ваше приложение, он будет перенаправлен на ваш Redirect 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
   
           // Prepare the POST data
           $postData = [
             'app_id' => $app_id,
             'app_secret' => $app_secret,
             'auth_key' => $auth_key
           ];
   
           // Initialize cURL
           $ch = curl_init('https://kastinginfo.com/api/authorize');
   
           // Set cURL options for POST
           curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
           curl_setopt($ch, CURLOPT_POST, true);
           curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($postData));
   
           // Execute request
           $response = curl_exec($ch);
   
           // Check for cURL errors
           if (curl_errno($ch)) {
             die('cURL error: ' . curl_error($ch));
           }
   
           curl_close($ch);
   
           // Decode the JSON response
           $json = json_decode($response, true);
   
           // Use the access token if available
           if (!empty($json['access_token'])) {
             $access_token = $json['access_token']; // your access token
           }
           ?>
           

   Это access_token действителен только 1 час, после истечения срока действия необходимо получить новый, перенаправив пользователя на вход через ссылку снова.

API-интерфейсы

Как только вы получите access_token Теперь вы можете получать информацию из нашей системы через HTTP GET-запросы с поддержкой следующих параметров

Вы можете получить информацию о пользователе, как это

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