Общая информация
Поддержка методов 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.