NEGA.land API's instructions
Основные особенности:
1. Особенности отправки POST запросов:
Система позволяет принимать пост запросы отдельными переменными, либо JSON строкой в виде POST запроса с переменной json
2. Порядок обработки уведомлений и ошибок:
Во всех ответах система может генерировать ряд уведомлений трёх типов: Ошибка, Уведомление и Успех действия
Внутри JSON передаётся параметр error . Если он равен '', то ответ успешный, он обработывается в-первую очередь. Если отдалась строка не пустая, значит действие не выполнено, причина описана в ошибке
Во-вторую очередь, параллельно с переменными ответа, могут отдаваться остальные нотисы в массиве notices, имеющие по 3 параметры каждый, а именно: Тип (error, info, ok), Текст нотиса и опциональный параметр длительности показа в секундах
3. Антикеш:
В запросе можно посылать произвольную рандомную гет переменную для предотвращения кеширования запроса, это неоходимо чтобы встроенные средства каждый раз наверняка запрашивали актуальные данные
4. Не фича, а баг... не баг, а фича... временная:
В некоторых методах отдаётся json в массиве, будтобы мы послали json[]=json ( array(array()) ).. При первоначальной разработке мы хотели отвечать несколькими ответами, обёрнутыми в единый json, но это не пригодилось.. однако, для поддержки имеющегося умирающего приложения этот баг (или фича) будет нас преследовать. у методов, где ответ надо разбирать через дополнительный json.forEach() указан синий нотис. в будущем мы разом избавимся от этого, переписав алгоритмы разбора.
Main functions
Authorization:
http://nega.land/api.php?mode=auth SECURE, 5 errors per hour by ip
This finction is bugged!!! json answer has included in array like array(array()), for support old app it's not fixed today
!IMPORTANT! POST param: email - E-Mail adress (like [email protected])
OR
!IMPORTANT! POST param: phone - Phone number (like +79012345678 or 79012345678 or 89012345678 or 9012345678)
!IMPORTANT! POST param: password - Password string
Answer: application/json; charset=utf-8
error - Notification if error
id - Account id
name - Firt user name
name2 - Last user name
phone - Phone number from account
email - Email from account
session - Session token for another requests
Registration:
api.php?mode=reg NOT SECURE, ONLY TEST , mode=GET , answer: application/json; charset=utf-8
This finction is bugged!!! json answer has included in array like array(array()), for support old app it's not fixed today
!IMPORTANT! POST param: email - E-Mail adress
!IMPORTANT! POST param: password - Password string
!IMPORTANT! POST param: regname - User real name string
!IMPORTANT! POST param: regfam - User last name string
!IMPORTANT! POST param: phone - mobile phone string
Reminder password:
api.php?mode=forgot NOT SECURE, ONLY TEST , mode=GET , answer: application/json; charset=utf-8
This finction is bugged!!! json answer has included in array like array(array()), for support old app it's not fixed today
!IMPORTANT! POST param: email - E-Mail adress
Social authentification start:
api.php?mode=socialstart , mode=GET , answer: application/json; charset=utf-8
Social authentification:
api.php?mode=socialauth NOT SECURE, ONLY TEST , mode=POST , answer: application/json; charset=utf-8
!IMPORTANT! POST param: token - Result string from ulogin
Onliner and news:
api.php?mode=online , mode=GET , answer: application/json; charset=utf-8
Add GET or POST params: session - session id
APP: Если авторизованы открываем браузером эту функцию. при ошибке авторизации будет выдана JSON строка
api.php?mode=app , mode=GET , answer: text/html; charset=utf-8
Add GET or POST params: session - session id
NEWS: Эту функцию открываем браузером, если заход в приложение осуществлён через всплывающее окно
api.php?mode=news , mode=GET , answer: text/html; charset=utf-8
Add GET or POST params: session - session id
GUEST FUNCTIONS:
AppGuestStart:
api.php?mode=online , mode=GET , answer: application/json; charset=utf-8
AppGuestZone
api.php?mode=online , mode=GET , answer: application/json; charset=utf-8
AppGuestZoneSelect
api.php?mode=online , mode=GET , answer: application/json; charset=utf-8
AppGuestZoneChange
api.php?mode=online , mode=GET , answer: application/json; charset=utf-8
AppGuestBonus
api.php?mode=online , mode=GET , answer: application/json; charset=utf-8
AppGuestBonusMove
api.php?mode=online , mode=GET , answer: application/json; charset=utf-8
AppGuestLevel
api.php?mode=online , mode=GET , answer: application/json; charset=utf-8
© 2016-2020 API v1.1.2 by Bicoz (http://bicoz.ru)