Техническая документация API - Получение информации о пользователе

Опубликовано: 04.10.2025

1. Обзор метода

Метод POST /api/user_id возвращает подробную информацию о пользователе социальной сети ВКонтакте.

2. Endpoint

POST https://api-k.ru/api/user_id

3. Параметры запроса

Тело запроса (JSON)

Параметр Тип Обязательный Описание
user_id string ✓ Идентификатор пользователя VK
fields string ✓ Список запрашиваемых полей через запятую

Доступные поля в параметре fields:

  • city - информация о городе
  • education - данные об образовании
  • career - информация о карьере
  • contacts - контактная информация
  • photo_max - фотография максимального размера
  • и другие стандартные поля VK API

4. Заголовки запроса

Заголовок Значение Обязательный
Content-Type application/json ✓

5. Пример использования

Пример запроса с cURL

curl -X POST https://api-k.ru/api/user_id \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "987654321",
    "fields": "city,education,photo_max"
  }'

Пример запроса на Python

import requests
import json

url = "https://api-k.ru/api/user_id"
headers = {"Content-Type": "application/json"}
data = {
    "user_id": "987654321",
    "fields": "city,education,photo_max"
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

Пример запроса на JavaScript

fetch('https://api-k.ru/api/user_id', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
        user_id: '987654321',
        fields: 'city,education,photo_max'
    })
})
.then(response => response.json())
.then(data => console.log(data));

6. Формат ответа

Успешный ответ (200 OK)

{
  "response": [
    {
      "id": 987654321,
      "first_name": "Сергей",
      "last_name": "Иванов",
      "sex": 2,
      "bdate": "15.8.1988",
      "city": {
        "id": 2,
        "title": "Санкт-Петербург"
      },
      "country": {
        "id": 1,
        "title": "Россия"
      },
      "photo_max": "https://example.com/photo_max.jpg",
      "online": 1,
      "education": {
        "university": 1,
        "university_name": "СПбГУ",
        "graduation": 2010
      },
      "career": [
        {
          "company": "Технологии будущего",
          "position": "Разработчик ПО"
        }
      ]
    }
  ]
}

Описание полей ответа

Поле Тип Описание
id integer Идентификатор пользователя
first_name string Имя пользователя
last_name string Фамилия пользователя
sex integer Пол (1 - женский, 2 - мужской)
bdate string Дата рождения
city object Город проживания
city.id integer ID города
city.title string Название города
country object Страна проживания
country.id integer ID страны
country.title string Название страны
photo_max string URL фотографии максимального размера
online integer Статус онлайн (1 - онлайн, 0 - офлайн)
education object Информация об образовании
education.university integer ID университета
education.university_name string Название университета
education.graduation integer Год окончания
career array Массив с информацией о карьере
career[].company string Название компании
career[].position string Должность

7. Коды состояния HTTP

Код Описание Возможные причины
200 OK Запрос выполнен успешно -
400 Bad Request Неверные параметры запроса Отсутствуют обязательные параметры, неверный формат данных
405 Method Not Allowed Используется неподдерживаемый HTTP метод Использован GET вместо POST
500 Internal Server Error Внутренняя ошибка сервера Проблемы на стороне сервера API

8. Обработка ошибок

При возникновении ошибки сервер возвращает соответствующий HTTP статус код. Рекомендуется реализовать обработку всех возможных кодов состояния в клиентском приложении.

9. Ограничения и рекомендации

  • Все запросы должны отправляться с заголовком Content-Type: application/json
  • Параметр user_id должен быть строкой, даже если передается числовой идентификатор
  • Список полей в параметре fields должен быть разделен запятыми без пробелов
  • Количество запросов в секунду - 1 запрос
  • Рекомендуется запрашивать только необходимые поля для оптимизации производительности

10. Поддержка

При возникновении проблем с использованием API обращайтесь в техническую поддержку с указанием: - Полного URL запроса - Тела запроса - Полного ответа сервера - Времени возникновения ошибки