Username & Password

Begin Username/Password Import

This import method requires that you collect your user’s username and password for their address book service.

  1. Your application collects the user’s username and password combination for the contact source requested.
  2. Your application calls the /begin_import/import endpoint, including the username/password plus the contact source requested.
  3. CloudSponge returns a result object indicating the request has been received and specifying an import_id for fetching events and contacts later.
  4. (Optional) Your application displays a status update to the user.

Now your application should go to Step 2 while CloudSponge downloads the address book for you.

Definition

POST https://api.cloudsponge.com/begin_import/import[.format]

Request Arguments

NameRequired?Description
domain_keyYesYour domain key.
domain_passwordYesYour domain password.
serviceYesService code (click here)
usernameYesYour user’s username for the contact source.
passwordYesYour user’s password for the contact source.
includeNoBy specifying mailing_address here, mailing addresses will be returned in addition to the other contact information.
user_idNoAny unique identifier you use to identify a user.
echoNoAny customer defined string data to be returned in the response.

Example Request

curl --user 33664218758c5244136965160db455db012b1411:Tpa01z+vVPE7MxXi \
     --request POST \
     --data "service=icloud" \
     --data "username=foo" \  
     --data "password=bar" \
     --url "https://api.cloudsponge.com/begin_import/import.json"

Response Variables

NameDescription
statussuccess or failure
import_idThe identifier for this import, used in subsequent calls to fetch events and contacts.
user_idThe customer defined string that was passed in as an argument.
echoThe customer defined string that was passed in as an argument.

Example Response (JSON)

{  
  "status": "success",  
  "import_id": 1126  
}

Example Response (XML)

<?xml version="1.0" encoding="UTF-8"?>
<result>
  <status>success</status>
  <import-id>1126</import-id>
</result>