anchor.diff:  
   == VKontakte API Binding
   Spring Social VKontakte offers integration with VKontakte's REST API with the `VKontakte` interface and its implementation, `VKontakteTemplate`.
  -
  -To create an instance of `VKontakteTemplate`, you may pass in your application's OAuth 2 access token to the constructor:
  +Before you start using it, please get familiar with VK Java SDK, check https://github.com/VKCOM/vk-java-sdk[github vk-java-sdk] also https://vk.com/dev/SDK[vk skd page].
  +Interaction with VK API is done through VK Java SDK, the main class to work there is `VkApiClient`, to perform most of the operations this class requires `Actor` instances.
  +Here comes Spring Social VKontakte -- it will provide instances of `Actor`.
  +Here's sample of how you can use `VKontakte` with VK Java SDK `VkApiClient`:
   
   ```java
  -String accessToken = "..."; // The access token granted after OAuth authorization
  -VKontakte vkontakte = new VKontakteTemplate(accessToken);
  +
  +    private final VKontakte vkontakte;
  +    @Inject
  +    public VKontakteFriendsController(VKontakte vkontakte) {
  +        this.vkontakte = vkontakte;
  +    }
  +
  +    @RequestMapping(value="/getIds", method=RequestMethod.GET)
  +    public String showFeed(Model model) throws ClientException, ApiException {
  +        VkApiClient vk = new VkApiClient(HttpTransportClient.getInstance());
  +        GetResponse userIds = vk.friends().get(vkontakte.getUserActor()).execute();
  +        List<String> ids = userIds.getItems().stream().map(Object::toString).collect(Collectors.toList());
  +        model.addAttribute("ids", ids);
  +
  +        return "getIds";
  +    }
   ```
   
   If you are using Spring Social's
  
positive.code: [source,groovy,subs="attributes,verbatim"]
  ----
  compile "org.springframework.social:spring-social-web:{spring-social-version}"
  ----
  
  Or in Maven:
  
negative.code: Here, `ConnectionRepository` is being asked for the primary connection that the current user has with VKontakte. 
  If a connection to VKontakte is found, it retrieves a `VKontakte` instance that is configured with the connection details received when the connection was first established.
  
  The `VKontakte` interface is defined as follows:
  
  ```java
  public interface VKontakte extends ApiBinding {
      public ServiceActor getServiceActor();
      public UserActor getUserActor();
      public String getEmail();
  }
  ```
  
  Here's description:
  
  [[table_subApis]]
  .VKontakte's methods
  [options="header",]
  |=======================================================================
  |Method           |Description
  |getServiceActor  |Returns instance of VK Java SDK ServiceActor
  |getUserActor     |Returns instance of VK Java SDK UserActor
  |getEmail         |Returns user email, if `email` scope was specified and user approved to share email.
  |=======================================================================
  