Намба API

Введение

Намба предоставляет разработчикам API для написания сторонних приложений, которые могут работать с Намбой.

API очень простое и не требует ни регистрации ключа, ни хитрых библиотек. Грубо говоря, есть набор урлов, на которые методом GET или POST нужно посылать запросы и получать ответы. Ответы можно получать в форматах json или xml.

Внимание! Намба предоставляет виджет Намба комментариев, который можно вставить на свой сайт. Ознакомиться с функционалом виджета и с инстукциями по использованию.

Внимание! Намба предоставляет виджет Намба чата, который можно вставить на свой сайт. Ознакомиться с функционалом виджета и с инстукциями по использованию.

Описание функций API

Получение информации о пользователе

Адрес: http://api.namba.kz/getUserInfo.php
Параметры: username={логин пользователя}, outputType={json или xml}
Тип запроса: GET или POST

Эта функция возращает информацию о пользователе.

В результате мы получим объект, который описывает пользователя. Приведу пример в формете JSON

{"status":"@\u0410\u0437\u0438\u043a\u043e - \u0441\u043a\u043e\u0440\u043e )))","login":"puzanov","firstname":"Oleg","lastname":"Puzanov","birthdate":"1983-03-10 00:00:00","sex":"0","avatar":"1514156,1514157,1514158"}

Поле sex - это пол, где 0 - мужской, а 1 - женский. Поле avatar - это список из трех идентификаторов картинок на Намба файлах, Чтобы получить картинку нужно запросить ее по адресу http://d{1,2,3}.files.namba.kz/files/{один их трех айдишников аватара}. Например http://d2.files.namba.kz/files/1514156

Получение списка друзей пользователя

Адрес: http://api.namba.kz/friends.php
Параметры: username={логин пользователя}, outputType={json или xml}
Тип запроса: GET или POST

Эта функция возращает информацию о пользователе. Описание полей такое же как и в информации о пользователе

Изменение статуса пользователя

Адрес: http://api.namba.kz/setStatus.php
Параметры: username={логин пользователя}, password={пароль пользователя}, status={текст статуса}, outputType={json или xml}
Тип запроса: только POST

Эта функция меняет статус пользователя.

События друзей пользователя

Адрес: http://api.namba.kz/getEvents.php
Параметры: username={логин пользователя}, password={пароль пользователя}, outputType={json или xml}
Тип запроса: только POST

Эта функция возвращает огромную структуру с описанием событий друзей пользователя. Описывать ее лень :)

Количество новых писем new

Адрес: http://api.namba.kz/getNewMailCount.php
Параметры: username={логин пользователя}, password={пароль пользователя}, outputType={json или xml}
Тип запроса: только POST

Возвращается количество новых писем в папке "Входящие"
Например {"new_messages":2}

Список последних писем new

Адрес: http://api.namba.kz/getLastMail.php
Параметры: username={логин пользователя}, password={пароль пользователя}, outputType={json или xml}
Тип запроса: только POST

Возвращается список последних писем в папке "Входящие". Количество писем не более 20. Сортировка по дате поступления.
Например [{"from":"Oleg Puzanov <puzanov@namba.kg>","subject":"another test","isRead":false},{"from":"Oleg Puzanov <puzanov@namba.kg>","subject":"test","isRead":true}]
From - от кого пришло письмо
Subject - заголовок письма
isRead - прочитано письмо или нет

Список видео пользователя new

Адрес: http://api.namba.kz/getVideo.php
Параметры: username={логин пользователя}, outputType={json или xml}
Тип запроса: GET или POST

Возвращается список видео пользователя. Сортировка по дате конвертации. Количество не более 30 штук
Если не передать параметр username, то вернется список последних 30 роликов
Описание полей:
title - название ролика
description - описание
size - размер в байтах
ctime - дата конвертации (формат UNIX timestamp)
duration - продолжительность
upload_user - логин пользователя, который закачал ролик
category_url - ссылка на категорию в которой находится этот ролик
video_url - ссылка на ролик
small_preview - ссылка на маленькое превью
medium_preview - ссылка на среднее превью
big_preview - ссылка на большое превью

Список фоток пользователя new

Адрес: http://api.namba.kz/getPhoto.php
Параметры: username={логин пользователя}, outputType={json или xml}
Тип запроса: GET или POST

Возвращается список фоток пользователя. Сортировка по дате создания. Количество не более 30 штук
Если не передать параметр username, то вернется список последних 30 фоток
Описание полей:
description - описание
uploadTime - дата создания
upload_user - логин пользователя, который закачал фотку
category_url - ссылка на категорию в которой находится эта фотка
photo_url - ссылка на фотку на сайте
preview - ссылка на маленькое превью
big_preview - ссылка на большое превью
real_photo - ссылка на фотку в оригинальном размере
filename - имя файла фотки