Документация API

Использовать наш API очень просто. Мы используем передачу данных по http, и в ответ отдаём обычный json.

Вы можете получить иформацию о профиле воспользовавшись следующим http запросом:

http://astralmagic.ru/api/v1/{api_key}/profile/{slug_or_id} 

Где {api_key} - это ваш ключ API, его можно получить тут{slug_or_id} - slug или id мага данные о котором вы хотите получить.

Пример на языке PHP:

  1. <?php 
  2.  
  3. // ваш ключ API
  4. $api_key = "d8defe0fe400f183a5f4aca4b032a516c0c9c5253babd7b9c8fb4648d214006659bce176f641d70d";
  5.  
  6. // slug или id мага
  7. $slug = "damir";
  8.  
  9. // выполнение http запроса
  10. $json = file_get_contents("http://astralmagic.ru/api/v1/{$api_key}/profile/{$slug}");
  11.  
  12. // декодирование json данных
  13. $data = json_decode($json);
  14.  
  15. // вывод результата на экран
  16. echo("<pre>");
  17. var_dump($data);
  18. echo("</pre>");
  19.  
  20. ?>

Ответ на запрос:

  1. {
  2.   "status": "success",
  3.   "result": {
  4.     "profile": {
  5.       "id": 20,
  6.       "site": "mag-damir.ru",
  7.       "name": "Дамир",
  8.       "slug": "damir",
  9.       "contacts": "Телейон: +7 (916) 403-41-27 Эл.почта - [email protected]",
  10.       "count_views": 7,
  11.       "rating": {
  12.         "good": 0,
  13.         "bad": 0,
  14.         "neutral": 0,
  15.         "total": 0,
  16.         "rating_value": 0
  17.       },
  18.       "date_of_create": "2018-10-15 23:19:43",
  19.       "category": {
  20.         "id": 10,
  21.         "title": "Маг",
  22.         "timestamp": "2018-09-24 23:15:13"
  23.         },
  24.       "site_url": "http://astralmagic.ru/redirect/original-url/20",
  25.       "url_to_profile": "http://astralmagic.ru/profile/damir"
  26.     },
  27.     "last_reviews": { [
  28.       {
  29.          "id": 42,
  30.          "username": "John Doe",
  31.          "message": {
  32.            "image_src": "data:image/png;base64...",
  33.            "text": "Lorem ipsum"
  34.          },
  35.          "image": "",
  36.          "date_of_create": "2018-10-16 19:56:39",
  37.          "rating_weight": "-1"
  38.        },
  39.        {
  40.          "id": 26,
  41.          "username": "Mike Tiger",
  42.          "message": {
  43.            "image_src": "",
  44.            "text": "Lorem ipsum 2"
  45.          },
  46.          "image": "",
  47.          "date_of_create": "2018-09-21 11:49:11",
  48.          "rating_weight": "1"
  49.        } ]
  50.     }
  51.   }
  52. }

Всего существует 2 запроса:

http://astralmagic.ru/api/v1/{api_key}/profile/{slug_or_id} - получить информацию об одном маге

http://astralmagic.ru/api/v1/{api_key}/high-profiles - получить список лучших магов на сайте, сортированых по рейтингу