SoMee Social - Разработчики

Версия API 1.1

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

Create Marketing App

To create your marketing app and begin using the marketing API, you must first register with Панель инструментов приложения. Registration creates a custom application in our system with a custom reward type and security key (API key) to use for our API access.

You will need to create a new Marketing App Create New Marketing App
Once you created your Marketing App you will get your API KEY and ability to see the docs.

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

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

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

After creating your Developer App

Войти в с

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

Начиная процесс входа в OAuth, вы должны использовать ссылку для своего приложения, как это:
```
<a href="https://somee.social/api/oauth?app_id=YOUR_APP_ID">Log in With SoMee Social</a>
```
Note also that you can pass a STATE URL parameter with your login url, and we'll pass that STATE parameter back to your server with that same code.

So, for example, let's say that you need to support login to your app with SoMee - but you need to know what specific PART of your app it's coming from, and you have some ID that you need to handle.

To do that, you would ENCRYPT/ENCODE (you should use an IV/KEY stored on your server, so only your system can decode the string) the state, and send the state with the login string:
```
<a href="https://somee.social/api/oauth?app_id=YOUR_APP_ID&state=YOUR_ENCODED_STRING">Log in With SoMee Social</a>
```
Пользователь будет перенаправлен на страницу входа в систему, как это
Как только пользователь примет ваше приложение, он будет перенаправлен на URL-адрес App Redirect с auth_key нравится это:
```
https://mydomain.com/my_redirect_url.php?auth_key=AUTH_KEY
```
--OR if you passed a state parameter--
```
https://mydomain.com/my_redirect_url.php?auth_key=AUTH_KEY&state=WHATEVER_YOU_SENT_WITH_LOGIN
```
Это auth_key действителен только для однократного использования, поэтому после его использования вы не сможете использовать его снова и сгенерировать новый код, вам нужно будет перенаправить пользователя на страницу входа по ссылке снова.
For security reasons, we are NOT storing the 'state' anywhere - meaning whatever you send us, gets sent back. So, you should get into the habit of confirming the state on YOUR end when before actually doing anything with the state data

Токен доступа

Как только вы получите одобрение вашего приложения, войдите в систему в оконном режиме и вернитесь с auth_key это означает, что теперь вы готовы извлечь данные из наших APIs и начать этот процесс, вам нужно будет авторизовать ваше приложение и получить 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://somee.social/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 часа, поэтому после того, как он станет недействительным, вам нужно будет переписать новый, перенаправив пользователя на страницу входа снова по ссылке.

Developer App APIs

Как только вы получите access_token you can then begin to interact with the main SoMee Developer API

Click View Docs to view the API documentation (we keep this updated all the time).