Show/Hide Toolbars

PerfectApps™ Help Guide

The Notify method allows you to send notifications through the API.

 

int Notify(string tokenIn, string appId, int instanceId, byte attentionLevel, string name, string roleName, 

string emailAddress, bool sendEmail, string messageSubject, string messageBody, bool cancelWhenOpen, int minutes, 

out string tokenOut)

 

Send Params

Return Params

cancelWhenOpen - If set to true, viewing the app is enough to cancel the notification. If set to false, a submit will cancel it.

emailAddress - This is the e-mail address we want the notification to go to.

appId - This is the ID of the app we want the notification to be sent from.

instanceId - This is the ID of the instance of the app we want the notification to be sent from.

messageBody - This is the body of the notification.

messageSubject - This is the subject of the notification.

name - This is the name that is used to display the notification in PerfectApps.

roleName - This is the workflow role associated with the notification.

sendEmail - True if we want the email to be sent or false if we only want it to appear as notification without a physical e-mail.

tokenIn - This is the security token that is obtained by the previous API call. See the API Security topic for more details.

tokenOut - This is the new security token that should be used for the next Web Service call after this one. See the API Security topic for more details.

 

SOAP 1.1

The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

 

POST /api/API.asmx HTTP/1.1

Host: app.perfectforms.com

Content-Type: text/xml; charset=utf-8

Content-Length: length

SOAPAction: "http://www.PerfectApps.com/API/Notify"

 

<?xml version="1.0" encoding="utf-8"?>

<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">

  <soap:Body>

    <Notify xmlns="http://www.PerfectApps.com/API">

      <tokenIn>string</tokenIn>

      <appId>string</appId>

      <instanceId>int</instanceId>

      <attentionLevel>unsignedByte</attentionLevel>

      <name>string</name>

      <roleName>string</roleName>

      <emailAddress>string</emailAddress>

      <sendEmail>boolean</sendEmail>

      <messageSubject>string</messageSubject>

      <messageBody>string</messageBody>

      <cancelWhenOpen>boolean</cancelWhenOpen>

      <minutes>int</minutes>

    </Notify>

  </soap:Body>

</soap:Envelope>

 

HTTP/1.1 200 OK

Content-Type: text/xml; charset=utf-8

Content-Length: length

 

<?xml version="1.0" encoding="utf-8"?>

<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">

  <soap:Body>

    <NotifyResponse xmlns="http://www.PerfectApps.com/API">

      <NotifyResult>int</NotifyResult>

      <tokenOut>string</tokenOut>

    </NotifyResponse>

  </soap:Body>

</soap:Envelope>

 

 

SOAP 1.2

The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

 

POST /api/API.asmx HTTP/1.1

Host: app.perfectforms.com

Content-Type: application/soap+xml; charset=utf-8

Content-Length: length

 

<?xml version="1.0" encoding="utf-8"?>

<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">

  <soap12:Body>

    <Notify xmlns="http://www.PerfectApps.com/API">

      <tokenIn>string</tokenIn>

      <appId>string</appId>

      <instanceId>int</instanceId>

      <attentionLevel>unsignedByte</attentionLevel>

      <name>string</name>

      <roleName>string</roleName>

      <emailAddress>string</emailAddress>

      <sendEmail>boolean</sendEmail>

      <messageSubject>string</messageSubject>

      <messageBody>string</messageBody>

      <cancelWhenOpen>boolean</cancelWhenOpen>

      <minutes>int</minutes>

    </Notify>

  </soap12:Body>

</soap12:Envelope>

 

HTTP/1.1 200 OK

Content-Type: application/soap+xml; charset=utf-8

Content-Length: length

 

<?xml version="1.0" encoding="utf-8"?>

<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">

  <soap12:Body>

    <NotifyResponse xmlns="http://www.PerfectApps.com/API">

      <NotifyResult>int</NotifyResult>

      <tokenOut>string</tokenOut>

    </NotifyResponse>

  </soap12:Body>

</soap12:Envelope>

 

 

Return to: Account API Methods (SOAP), Integration