MascusAPISoap / AddContactRequest

ASP AutoIt C C (Unicode) C++ C++ (Unicode) C# DataFlex Delphi Foxpro Go Java Node.js Objective-C Perl PHP Extension PowerBuilder Powershell PureBasic Python CkPython Ruby SQL Server Swift TCL VB.NET VB6 VBScript Xojo

IncludeFile "CkHttp.pb"
IncludeFile "CkHttpResponse.pb"
IncludeFile "CkXml.pb"

Procedure ChilkatExample()

    xml.i = CkXml::ckCreate()
    If xml.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkXml::setCkTag(xml, "soapenv:Envelope")
    CkXml::ckAddAttribute(xml,"xmlns:api","http://services.mascus.com/api")
    CkXml::ckAddAttribute(xml,"xmlns:soapenv","http://schemas.xmlsoap.org/soap/envelope/")
    CkXml::ckUpdateChildContent(xml,"soapenv:Header","")
    CkXml::ckUpdateChildContent(xml,"soapenv:Body|api:AddContactRequest|api:sessionId","string")
    CkXml::ckUpdateChildContent(xml,"soapenv:Body|api:AddContactRequest|api:ProductID","string")
    CkXml::ckUpdateChildContent(xml,"soapenv:Body|api:AddContactRequest|api:GivenName","string")
    CkXml::ckUpdateChildContent(xml,"soapenv:Body|api:AddContactRequest|api:GivenEmail","string")
    CkXml::ckUpdateChildContent(xml,"soapenv:Body|api:AddContactRequest|api:GivenPhone","string")
    CkXml::ckUpdateChildContent(xml,"soapenv:Body|api:AddContactRequest|api:GivenAddress","string")
    CkXml::ckUpdateChildContent(xml,"soapenv:Body|api:AddContactRequest|api:GivenCity","string")
    CkXml::ckUpdateChildContent(xml,"soapenv:Body|api:AddContactRequest|api:GivenPostalCode","string")
    CkXml::ckUpdateChildContent(xml,"soapenv:Body|api:AddContactRequest|api:GivenProvince","string")
    CkXml::ckUpdateChildContent(xml,"soapenv:Body|api:AddContactRequest|api:GivenCountry","string")
    CkXml::ckUpdateChildContent(xml,"soapenv:Body|api:AddContactRequest|api:RequestText","string")
    CkXml::ckUpdateChildContent(xml,"soapenv:Body|api:AddContactRequest|api:customEmailSubject","string")
    CkXml::ckUpdateChildContent(xml,"soapenv:Body|api:AddContactRequest|api:TestReceiverEmail","string")

    ; In a SOAP HTTP request, including the XML declaration (<?xml version="1.0" encoding="UTF-8"?>) in the XML body is generally not required. 
    CkXml::setCkEmitXmlDecl(xml, 0)
    soapRequestBody.s = CkXml::ckGetXml(xml)

    endpoint.s = "https://services.mascus.com/api/mascusapi.asmx"
    soapAction.s = "http://services.mascus.com/api/AddContactRequest"
    ;  For SOAP requests, the standard Content-Type is usually set to "text/xml" or "application/soap+xml"
    contentType.s = "text/xml"

    http.i = CkHttp::ckCreate()
    If http.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkHttp::ckClearHeaders(http)
    CkHttp::ckSetRequestHeader(http,"Content-Type",contentType)
    CkHttp::ckSetRequestHeader(http,"SOAPAction",soapAction)

    resp.i = CkHttp::ckPostXml(http,endpoint,soapRequestBody,"utf-8")
    If CkHttp::ckLastMethodSuccess(http) = 0
        Debug CkHttp::ckLastErrorText(http)
        Debug "Failed to send SOAP request."
        CkXml::ckDispose(xml)
        CkHttp::ckDispose(http)
        ProcedureReturn
    EndIf

    ; Get the XML response body.
    responseXml.i = CkXml::ckCreate()
    If responseXml.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkHttpResponse::ckGetBodyXml(resp,responseXml)

    statusCode.i = CkHttpResponse::ckStatusCode(resp)
    Debug "response status code: " + Str(statusCode)

    CkHttpResponse::ckDispose(resp)

    ; If the status code does not indicate succcess, then show the response XML,
    ; which probably contains error information.
    If statusCode <> 200
        Debug CkXml::ckGetXml(responseXml)
        CkXml::ckDispose(xml)
        CkHttp::ckDispose(http)
        CkXml::ckDispose(responseXml)
        ProcedureReturn
    EndIf

    Debug CkXml::ckGetXml(responseXml)

    ; Parse the successful SOAP response XML.

    ; This is a sample of the response XML, but the namespace prefixes will be different.
    ; We can parse the result using "*" for the namespace prefixes (see below).

    AddContactRequestResult.s = CkXml::ckGetChildContent(responseXml,"*:Body|*:AddContactRequestResponse|*:AddContactRequestResult")


    CkXml::ckDispose(xml)
    CkHttp::ckDispose(http)
    CkXml::ckDispose(responseXml)


    ProcedureReturn
EndProcedure

Request XML

<soapenv:Envelope xmlns:api="http://services.mascus.com/api" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Header/>
    <soapenv:Body>
        <api:AddContactRequest>
            <api:sessionId>string</api:sessionId>
            <api:ProductID>string</api:ProductID>
            <api:GivenName>string</api:GivenName>
            <api:GivenEmail>string</api:GivenEmail>
            <api:GivenPhone>string</api:GivenPhone>
            <api:GivenAddress>string</api:GivenAddress>
            <api:GivenCity>string</api:GivenCity>
            <api:GivenPostalCode>string</api:GivenPostalCode>
            <api:GivenProvince>string</api:GivenProvince>
            <api:GivenCountry>string</api:GivenCountry>
            <api:RequestText>string</api:RequestText>
            <api:customEmailSubject>string</api:customEmailSubject>
            <api:TestReceiverEmail>string</api:TestReceiverEmail>
        </api:AddContactRequest>
    </soapenv:Body>
</soapenv:Envelope>

Response XML

<soapenv:Envelope xmlns:api="http://services.mascus.com/api" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Header/>
    <soapenv:Body>
        <api:AddContactRequestResponse>
            <api:AddContactRequestResult>string</api:AddContactRequestResult>
        </api:AddContactRequestResponse>
    </soapenv:Body>
</soapenv:Envelope>