*
Константы:
HTTP_SUCCESS = 200 - успешно
HTTP_CREATED = 201 - объект создан
HTTP_NO_CONTENT = 204 - нет данных, ответ на запрос пуст
HTTP_MOVED_PERMANENTLY = 301 - переадресация на указанный адрес в поле location
HTTP_MOVED_TEMPORARILY = 302 - временная переадресация на указанный адрес в поле location
HTTP_SEE_OTHER = 303 -
HTTP_NEED_SEND_POST_TO_URL = 303 -
HTTP_BAD_REQUEST = 400 - неверный запрос
HTTP_UNAUTHORIZED = 401 - требуется авторизация
HTTP_PAYMENT_REQUIRED = 402 - необходима оплата
HTTP_FORBIDDEN = 403 - недоступно
HTTP_NOT_FOUND = 404 - объект не найден
HTTP_METHOD_NOT_ALLOWED = 405 - метод не поддерживается или не хватает параметров, в error описание проблемы
HTTP_NOT_ENOUGH_DATA = 422 - недостаточно данных для выполнения запроса, список недостающих данных передан в поле inputs
HTTP_TOO_MANY_REQUESTS = 429 - Превышен лимит запросов
HTTP_PERMISSION_DENIED = 550 - нет прав доступа к данному объекту
http://harlik.com/api.php?obj=Contact&m=put
добавление новых контактов, используется для синхронизации
входные параметры:
items =["key":abcdef123, last_update,
phones =
{"label":"_$!<Mobile>!$_","type":0,"data":"+79381597072"}
{"label":"home","type":1,"data":"89034063367"}'
]
name, [email], birthday, img - ссылка на аватарку с полным путем или имя файла в архиве]
если контакт удален, то ["key": 8, "delete"=true|1]
items может передаваться как массивом, или и в формате json или json внутри txt-файла внутри единственного переданного zip-архива. В этом случае в архиве могут быть вложены аватарки.
длина key 7 и больше символов
reload=1 - Укажите для полного обновления контактов, - при этом все отсутствующие в данной передаче контакты будут удалены. Аватарки повторно передавать необязательно, они сохраняться, если key не будет изменен.
возвращает:
HTTP_SUCCESS
http://harlik.com/api.php?obj=Contact&m=get
получение контактов, используется для синхронизации
входные параметры:
time - после какого времени выдать данные, integer
возвращает:
HTTP_SUCCESS + items[[
name - имя как в телефоне,
phone - телефон по которому соответствует устройство,
device=[id, name, img, key], [] ]
key=id контакта в телефоне
или HTTP_NO_CONTENT
http://harlik.com/api.php?obj=Contact&m=count
Возвращает кол-во контактов пользователя
входные параметры:
нет
возвращает:
HTTP_SUCCESS + count
отправляет PUSH:
m=message_del, device_id, device_name, id
http://harlik.com/api.php?obj=Contact&m=find
поиск контакта в моей записной книжке по имени, номеру телефона или части номера телефона
входные параметры:
q - что ищем
todo all=1 - показать все контакты, иначе, только те, у которых строит приложение
deleted=1 - показать удаленные. Все удаленные записи возвращаются в полях с суфиксом _del, например: phones_del, emails_del в формате ['значение'=>дата_удаления]
p=страница (умолчание =0)
perpage=кол-во на странице (умолчание =30)
возвращает:
HTTP_SUCCESS + items[[name, img, key, birthday, phones, emails, id(если установлено приложение)], [] ] или HTTP_NO_CONTENT
http://harlik.com/api.php?obj=Contact&m=search
поиск контакта по номеру телефона среди всех давших согласие делиться своей телефонной книгой
входные параметры:
phone - номер телефона
возвращает в формате json для приложения "Кто звонил":
name, city, birthday, email, image