Общая информация

Поддержка методов Graph API в текущий момент доступна только для групп. Как получить токен Graph API в группе

Список Graph API - методов

Graph API - другое представление API, основанное на протоколе HTTP.

Основными особенностями и отличиями Graph API от традиционного REST API Одноклассников является следующее:

  • поддерживается только формат данных JSON;
  • не требуется подпись запроса;
  • принцип работы и результат выполнения метода при вызове с помощью POST и GET запросов могут различаться;
  • сессионный токен отсутствует, вместо него - Graph API токен.

Запрос в Graph API состоит из следующих компонентов:

  • адрес сервера API ({api_server}). На текущий момент: https://api.ok.ru/graph;
  • узел - основной объект, над которым или над подобъектами которого производятся действия. Например, /me - пользователь;
  • границы - необязательный объект, который связан с узлом запроса. Например, сообщения пользователя или группы - /messages;
  • поля - список параметров объекта, то есть информация о них, которая используется в запросе. Например, timestamp=0 - время создания сообщения;
  • access_token - маркер доступа к Graph API.

Структура URL запроса в общем виде выглядит так:

{api_server}/[узел]/[границы]?access_token=[access_token]&поле1=[значение1]&поле2=[значение2]

Например:

https://api.ok.ru/graph/me/messages/chat:C3ecb9d02a600?access_token=tkn1souiIRv:CBAQMCGGABABABABA&to=0

Bot API

В Graph API уже реализованы методы, позволяющие автоматизировать общение с вашими пользователями в группах через групповые чаты: ознакомиться с документацией Bot API.