Серверный API

contacts.getFolderContactList

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

Уровень доступа: 3 - Общий доступ + Права на доступ к контактам пользователя

Описание:

Метод возвращает сначала контакты из папки «Избранные», затем из «Общая папка» и далее по остальным папкам, пока не будет достигнут запрашиваемый лимит. Если общее количества контактов пользователя меньше запрашиваемого лимита — выводятся все контакты.

Параметры:
Название Обязательный параметр Описание
sid +
folder_id по умолчанию сообщения попадают в «Общую» папку и если если параметр не передан, метод возвращает сообщения из этой папки
online Если параметр передан, метод возвращает данные только тех контактов, которые находятся в момент вызова на сайте. Если нет - все контакты.
limit лимит запрашиваемых данных (не больше 100, по умолчанию = 100)
offset по умолчанию = 0
blocks Работает так же как аналогичный параметр метода anketa.getInfo. Блоки указываются через запятую: about, location, flags, familiarity, type, interests. Если параметр не задан, выводятся только блоки info, location и flags.
ids_only если параметр установлен (=1) - метод возвращает только id анкет, если же нет - то обычное поведение метода"
Ответ метода:
{
    "status": int,
    "message": "str"
    "data":{
        "contacts":[
            {
                "info":{
                    "oid": int,
                    "login": "str",
                    "name": "str",
                    "gender": "str",
                    "anketa_link": "str",
                    "small_photo_url": "str",
                    "medium_photo_url": "str",
                    "square_photo_url": "str",
                    "age": int,
                    "sign": "str",
                    "lang": "str",
                    "is_app_user": int
                },
                "message_count": int,
                "location":{
                    "country_id": int,
                    "region_id": int,
                    "city_id": int,
                    "metro_id": int,
                    "country": "str",
                    "region": "str",
                    "city": "str",
                    "metro": "str"
                },
                "flags":{
                    "is_vip": int,
                    "is_real": int,
                    "is_leader": int,
                    "maketop": int,
                    "is_online": int
                },
                "about": "str",
                "familiarity":{
                    "lookfor": "str",
                    "waitingfor": "str",
                    "targets":[
                        "str",
                        "str"
                    ],
                    "iam":{
                        "stat" : "str",
                    },
                    "marital": "str",
                    "children": "str"
                },
                "type":{
                    "height": int,
                    "weight": int,
                    "circumstance": "str",
                    "constitution": "str",
                    "smoke": "str",
                    "drink": "str",
                    "home": "str",
                    "language":[
                        "str",
                        "str",
                        "str"
                    ],
                    "race": "str",
                    "orientation": "str"
                },
                "interests":[
                    "str",
                    "str",
                    "str"
                ]
            },
            ...
        ]
    }
}