CCC API v8.4.0.0

<back to all web services

UpdateGatewayServiceSettings

The following routes are available for this service:
PUT/api/gateways/{GatewayGuid}/services/{ServiceGuid}/settingsUpdates the settings for a service for a gateway instnace.
UpdateGatewayServiceSettings Parameters:
NameParameterData TypeRequiredDescription
GatewayGuidpathGuidYesIdentifies the gateway instance.
ServiceGuidpathGuidYesIdentifies the service instance.
DiscardSameDomainNotificationsbodyBooleanNoUsed to prevent/discard notifications to recipients in the sender's domain
SendNotificationViaServerbodyBooleanNoIf true, the gateway relies on 'server' to send the notification message. If false, a secure message notification message is sent by the Gateway.
GatewayServiceSettingsResponse Parameters:
NameParameterData TypeRequiredDescription
ResponseStatusformResponseStatusNo
GatewayServiceSettings Parameters:
NameParameterData TypeRequiredDescription
SystemUserEmailAddressformstringNo
DefaultProPackageformstringNo
CustomSMTPSenderEmailformstringNo
CustomSMTPSenderNameformstringNo
CustomSMTPDNREmailformstringNo
DiscardSameDomainNotificationsbodyBooleanNo
SendNotificationViaServerbodyBooleanNo
MessageRulesbodyGatewayServiceMessageRule[]No
GatewayService Parameters:
NameParameterData TypeRequiredDescription
ServiceGuidbodyGuidNo
ServiceNameformstringNo
MessagingApiUrlformstringNo
GatewaySettingsUrlformstringNo
ServiceCodeformstringNo
PrimaryDomainformstringNo
SecondaryDomainsformstring[]No
GatewayServiceMessageRule Parameters:
NameParameterData TypeRequiredDescription
ServiceGuidformGuidNo
GatewayMessageRule Parameters:
NameParameterData TypeRequiredDescription
MessageRuleGuidformGuidNo
GatewayGuidformGuidNo
CostformlongNo
EnabledformboolNo
CheckNextRuleIfformintNo
DescriptionformstringNo
MatchExpressionformstringNo

To override the Content-type in your clients, use the HTTP Accept Header, append the .json suffix or ?format=json

To embed the response in a jsonp callback, append ?callback=myCallback

HTTP + JSON

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

PUT /api/gateways/{GatewayGuid}/services/{ServiceGuid}/settings HTTP/1.1 
Host: api.secure-messaging.com 
Accept: application/json
Content-Type: application/json
Content-Length: length

{
  "gatewayGuid": "00000000000000000000000000000000",
  "serviceGuid": "00000000000000000000000000000000",
  "discardSameDomainNotifications": false,
  "sendNotificationViaServer": false
}
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{
  "responseStatus": {
    "errorCode": "String",
    "message": "String",
    "stackTrace": "String",
    "errors": [
      {
        "errorCode": "String",
        "fieldName": "String",
        "message": "String",
        "meta": {
          "String": "String"
        }
      }
    ],
    "meta": {
      "String": "String"
    }
  },
  "systemUserEmailAddress": "String",
  "defaultProPackage": "String",
  "customSMTPSenderEmail": "String",
  "customSMTPSenderName": "String",
  "customSMTPDNREmail": "String",
  "discardSameDomainNotifications": false,
  "sendNotificationViaServer": false,
  "messageRules": [
    {
      "serviceGuid": "00000000000000000000000000000000",
      "messageRuleGuid": "00000000000000000000000000000000",
      "gatewayGuid": "00000000000000000000000000000000",
      "cost": 0,
      "enabled": false,
      "checkNextRuleIf": 0,
      "description": "String",
      "matchExpression": "String"
    }
  ],
  "serviceGuid": "00000000000000000000000000000000",
  "serviceName": "String",
  "messagingApiUrl": "String",
  "gatewaySettingsUrl": "String",
  "serviceCode": "String",
  "primaryDomain": "String",
  "secondaryDomains": [
    "String"
  ]
}