Handles the callback from an Open Authentication provider and fetches the user's address book
| Client Servlet | Server Servlet | HTTP Methods Supported | Requires Authentication |
|---|---|---|---|
| CRAddressBookAPI | None. | GET, POST | No. |
Prior to calling this method, you must successfully call startOnlineAddressBookImport and redirect the user to the authentication URL returned by the host provider.
This method passes the returned OAuth credentials to the hosting provider along with a request to begin the download job. After the user authenticates with the hosting provider and gives consent for your app to access his address book, the hosting provider redirects to the URL in the callback_url parameter of startOnlineAddressBookImport. The callback_url may specify this method directly, or may specify a page on your web server containing script that calls this method (for an example, see the callback handler page in TeamRaiser Participant Center, /pc2/address_book_import_oauth_callback_handler.html).
See topic Common Parameters.
Required. OAuth 2 code
Type xsd:token.
Required. ID of an address book import job.
Type xsd:integer.
Required. Open Authentication token.
Type xsd:token.
Required. Open Authentication verifier.
Type xsd:token.
See topic HTTP Status Codes.
XML response
<?xml version="1.0" encoding="UTF-8"?>
<addressBookImportOAuthCallbackResponse xsi:schemaLocation="http://convio.com/crm/v1.0 http://service.convio.net/xmlschema/crm.public.v1.xsd" xmlns="http://convio.com/crm/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">OK</addressBookImportOAuthCallbackResponse>
JSON response
{"addressBookImportOAuthCallbackResponse":{"content":"OK"}}