Xbase++ Requires Chilkat v11.0.0+
Xbase++
Constant Contact V3: Restore a deleted contact to a list
See more Constant Contact Examples
Look up the deleted contact by email, then restore it by adding its existing ID to a chosen list. Constant Contact documents this membership activity as a restoration method. It changes only membership, preserves the saved profile, and makes no email-permission claim. Select the intended destination list explicitly; previous memberships were removed by deletion. Authorize the app first and use the same credential store.
Constant Contact developer guide
Chilkat Xbase++ Downloads
LOCAL nSuccess
LOCAL oVault
LOCAL oEntry
LOCAL oTokens
LOCAL nLoaded
LOCAL oHttp
LOCAL oResp
LOCAL oQuery
LOCAL oMatches
LOCAL oBody
LOCAL oJob
LOCAL cActivityId
LOCAL nAttempt
LOCAL cState
LOCAL i
nSuccess := 0
// Assumes Chilkat is unlocked. See Global Unlock Sample.
oVault := CreateObject("Chilkat.Secrets")
oVault:Location := "local_manager"
oVault:AutoSplit := 1
oEntry := CreateObject("Chilkat.JsonObject")
oEntry:UpdateString("appName", "ConstantContactV3")
oEntry:UpdateString("service", "OAuth2")
oEntry:UpdateString("username", "my-account")
oTokens := CreateObject("Chilkat.JsonObject")
nLoaded := oVault:GetSecretJson(oEntry, oTokens)
IF (nLoaded != 1)
? "Run the desktop authorization example using this account and store."
oVault:destroy()
oEntry:destroy()
oTokens:destroy()
RETURN
ENDIF
IF (oTokens:JsonTypeOf("access_token") != 1)
? "The saved authorization has no access token."
oVault:destroy()
oEntry:destroy()
oTokens:destroy()
RETURN
ENDIF
oHttp := CreateObject("Chilkat.Http")
oHttp:RequireSslCertVerify := 1
oHttp:AuthToken := oTokens:StringOf("access_token")
oResp := CreateObject("Chilkat.HttpResponse")
oQuery := CreateObject("Chilkat.HttpRequest")
oQuery:HttpVerb := "GET"
oQuery:AddParam("email", "reader+newsletter@example.com")
oQuery:AddParam("status", "deleted")
nSuccess := oHttp:HttpReq("https://api.cc.email/v3/contacts", oQuery, oResp)
IF ((nSuccess != 1) .OR. (oResp:StatusCode != 200))
? "Expected HTTP 200. Received " + Str(oResp:StatusCode)
IF (oResp:StatusCode == 401)
? "Refresh the saved access token or authorize again."
ENDIF
oVault:destroy()
oEntry:destroy()
oTokens:destroy()
oHttp:destroy()
oResp:destroy()
oQuery:destroy()
RETURN
ENDIF
oMatches := CreateObject("Chilkat.JsonObject")
nSuccess := oMatches:Load(oResp:BodyStr)
IF (nSuccess != 1)
? "Expected a JSON response."
oVault:destroy()
oEntry:destroy()
oTokens:destroy()
oHttp:destroy()
oResp:destroy()
oQuery:destroy()
oMatches:destroy()
RETURN
ENDIF
IF ((oMatches:SizeOfArray("contacts") != 1) .OR. (oMatches:JsonTypeOf("contacts[0].deleted_at") != 1))
? "Expected one deleted contact for this email. No restoration submitted."
oVault:destroy()
oEntry:destroy()
oTokens:destroy()
oHttp:destroy()
oResp:destroy()
oQuery:destroy()
oMatches:destroy()
RETURN
ENDIF
IF ((oMatches:JsonTypeOf("contacts[0].contact_id") != 1) .OR. (oMatches:StringOfEquals("contacts[0].contact_id", "", 1) == 1))
? "Missing contacts[0].contact_id in the response."
oVault:destroy()
oEntry:destroy()
oTokens:destroy()
oHttp:destroy()
oResp:destroy()
oQuery:destroy()
oMatches:destroy()
RETURN
ENDIF
oBody := CreateObject("Chilkat.JsonObject")
oBody:UpdateString("source.contact_ids[0]", oMatches:StringOf("contacts[0].contact_id"))
oBody:UpdateString("list_ids[0]", "DESTINATION_LIST_ID")
nSuccess := oHttp:HttpJson("POST", "https://api.cc.email/v3/activities/add_list_memberships", oBody, "application/json", oResp)
IF ((nSuccess != 1) .OR. (oResp:StatusCode < 200) .OR. (oResp:StatusCode >= 300))
? "Could not start the membership activity. HTTP " + Str(oResp:StatusCode)
oVault:destroy()
oEntry:destroy()
oTokens:destroy()
oHttp:destroy()
oResp:destroy()
oQuery:destroy()
oMatches:destroy()
oBody:destroy()
RETURN
ENDIF
oJob := CreateObject("Chilkat.JsonObject")
nSuccess := oJob:Load(oResp:BodyStr)
IF (nSuccess != 1)
? "Expected a JSON response."
oVault:destroy()
oEntry:destroy()
oTokens:destroy()
oHttp:destroy()
oResp:destroy()
oQuery:destroy()
oMatches:destroy()
oBody:destroy()
oJob:destroy()
RETURN
ENDIF
IF ((oJob:JsonTypeOf("activity_id") != 1) .OR. (oJob:StringOfEquals("activity_id", "", 1) == 1))
? "Missing activity_id in the response."
oVault:destroy()
oEntry:destroy()
oTokens:destroy()
oHttp:destroy()
oResp:destroy()
oQuery:destroy()
oMatches:destroy()
oBody:destroy()
oJob:destroy()
RETURN
ENDIF
cActivityId := oJob:StringOf("activity_id")
? "Submitted activity ID: " + cActivityId
oHttp:SetUrlVar("job", cActivityId)
// Poll briefly. A longer-running job can be checked later using the same ID.
nAttempt := 0
DO WHILE (nAttempt < 5)
nSuccess := oHttp:HttpNoBody("GET", "https://api.cc.email/v3/activities/{$job}", oResp)
IF ((nSuccess != 1) .OR. (oResp:StatusCode != 200))
? "Status check returned HTTP " + Str(oResp:StatusCode) + ". Keep the activity ID and check again later."
oVault:destroy()
oEntry:destroy()
oTokens:destroy()
oHttp:destroy()
oResp:destroy()
oQuery:destroy()
oMatches:destroy()
oBody:destroy()
oJob:destroy()
RETURN
ENDIF
nSuccess := oJob:Load(oResp:BodyStr)
IF ((nSuccess != 1) .OR. (oJob:JsonTypeOf("state") != 1))
? "Missing activity state. Keep the activity ID."
oVault:destroy()
oEntry:destroy()
oTokens:destroy()
oHttp:destroy()
oResp:destroy()
oQuery:destroy()
oMatches:destroy()
oBody:destroy()
oJob:destroy()
RETURN
ENDIF
cState := oJob:StringOf("state")
IF ((cState != "initialized") .AND. (cState != "processing"))
? "Activity state: " + cState
i := 0
DO WHILE (i < oJob:SizeOfArray("activity_errors"))
oJob:I := i
? oJob:StringOf("activity_errors[i]")
i := i + 1
ENDDO
oVault:destroy()
oEntry:destroy()
oTokens:destroy()
oHttp:destroy()
oResp:destroy()
oQuery:destroy()
oMatches:destroy()
oBody:destroy()
oJob:destroy()
RETURN
ENDIF
nAttempt := nAttempt + 1
IF (nAttempt < 5)
oHttp:SleepMs(2000)
ENDIF
ENDDO
? "Still processing. Recheck the activity ID before submitting another request."
oVault:destroy()
oEntry:destroy()
oTokens:destroy()
oHttp:destroy()
oResp:destroy()
oQuery:destroy()
oMatches:destroy()
oBody:destroy()
oJob:destroy()