Hammy API

Send API V2

HammySend2API WSDL letöltése

Send

Web service API

Kérés

A kötelező oszlop jelentése:

  • * - Minden esetben kötelező
  • E - EMAIL channel esetén kötelező
  • P - POST channel esetén kötelező
  • A - ARCHIVE channel esetén kötelező
NévTípusLeírásKötelező
clientHashKeyStringA webszolgáltatást hívó kliens azonosítója.*
requestIdString (150)A kérés azonosítója a hívó oldalon.
batchIdString (100)A levélköteg azonosítója.
partnerRefString (100)Partner azonosító.
messageTypeString (100)A kérés típusa. Értéke egy Hammy-ben létező levélsablon azonosítója.
messageTypeVersionIntegerA levélhez tartozó template verziószáma.
mailSubjectString (600)Email tárgya. A mező, illetve a messageType egyidejűleg nem adható meg.
mailBodyString (CLOB)Email szövege. A mező, illetve a messageType egyidejűleg nem adható meg.
mailHtmlBodyString (CLOB)HTML email szövege. A mező, illetve a messageType egyidejűleg nem adható meg.
recipientPostalAddressString (255)A címzett teljes postai címe.P
recipientEmailAddressString (100)A címzett email címe.E
recipientNameString (100)A címzett teljes neve.*
recipientEmailAddressCCString (100)A másolatot kapó személy email címe. Pontosvesszővel felsorolva több is megadható.
recipientNameCCString (100)A másolatot kapó személy neve.
replyToAddressString (100)A válasz-email címe.
replyToNameString (100)A válasz-email neve.
fromAddressString (100)A küldő email címe.
fromNameString (100)A küldő teljes neve.
bccAddressString (150)Titkos másolat email cím.
xmlDataString (CLOB)Az üzenethez tartozó adatok XML formátumban.
archivingExpectedBooleantrue esetén a levél tárgya és szövege archiválódik.
certificationExpectedBooleantrue érték esetén a levél aláírásra kerül.
channelMessageChannelA csatorna típusa.
userNameStringA felhasználó neve.
relatedMessageIdIntegerKapcsolódó üzenet Id.
replyEnvelopeAttachedBooleantrue jelzi , hogy az üzenethez válaszboríték van csatolva.
paymentSlipAttachedBooleantrue jelzi , hogy az üzenethez csekk van csatolva.
campaignPartIdIntegerKampány rész azonosító id.
letterTypeString (LetterType)A postai levél típusa.P
attachmentsAttachment_V1 [ ]A csatolmányokat tartalmazó lista.A
propertiesProperty_V1 [ ]Az üzenethez tartozó egyéb adatok, metaadatok.
paramsParam_V1 [ ]A szolgáltatás működését befolyásoló egyéb paraméterek listája.

Válasz

NévTípusLeírás
messageIdIntegerAz aktuális levél adatbázisbeli azonosítója.
statusResponseStatus_V1A válasz státusza.
paramsParam_V1 [ ]A szolgáltatás működését befolyásoló egyéb paraméterek listája.

Minta


<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:send="http://send.api.hammy.dbx.hu/">
    <soapenv:Header/>
    <soapenv:Body>
        <send:sendMail>
            <request>
                <clientHashKey>aa87cd4bcd3445bbc4</clientHashKey>
                <recipientEmailAddress>emailaddress@dbx.hu</recipientEmailAddress>
                <recipientName>NAME</recipientName>
                <mailSubject>Teszt levél tárgy</mailSubject>
                <mailBody>Teszt levél szöveg</mailBody>
                <fromAddress>norepy@dbx.hu</fromAddress>
                <fromName>NAME</fromName>
                <xmlData>
                    &lt;DATA&gt;
                    &lt;contractNumber&gt;10000001&lt;/contractNumber&gt;
                    &lt;clientID&gt;9000001&lt;/clientID&gt;
                    &lt;/DATA&gt;
                </xmlData>
                <archivingExpected>false</archivingExpected>
                <certificationExpected>false</certificationExpected>
            </request>
        </send:sendMail>
    </soapenv:Body>
</soapenv:Envelope>

REST API

REST API Info

Kérés

POST hammy/json/send/v2/send

multipart/form-data vagy multipart/mixed kérés.

A kötelező oszlop jelentése:

  • * - Minden esetben kötelező
  • E - EMAIL, PORTAL channel esetén kötelező
  • P - POST channel esetén kötelező
  • A - ARCHIVE channel esetén kötelező

multipart név: message

NévTípusLeírásKötelező
requestMetaJRequestMeta_V1Metainformációk.
requestIdString (150)A kérés azonosítója a hívó oldalon.
batchIdString (100)A levélköteg azonosítója.
partnerRefString (100)Partner azonosító.
messageTypeString (100)A kérés típusa. Értéke egy Hammy-ben létező levélsablon azonosítója.
letterTypeString (LetterType)A postai levél típusa.P
messageTypeVersionIntegerA levélhez tartozó template verziószáma.
mailSubjectString (600)Email tárgya. A mező, illetve a messageType egyidejűleg nem adható meg.
mailBodyString (CLOB)Email szövege. A mező, illetve a messageType egyidejűleg nem adható meg.
mailHtmlBodyString (CLOB)HTML email szövege. A mező, illetve a messageType egyidejűleg nem adható meg.
recipientEmailAddressString (100)A címzett email címe.E
recipientPostalAddressString (255)A címzett teljes postai címe.P
recipientNameString (100)A címzett teljes neve.*
recipientEmailAddressCCString (100)A másolatot kapó személy email címe. Pontosvesszővel felsorolva több is megadható.
recipientNameCCString (100)A másolatot kapó személy neve.
replyToAddressString (100)A válasz-email címe.
replyToNameString (100)A válasz-email neve.
fromAddressString (100)A küldő email címe.
fromNameString (100)A küldő teljes neve.
bccAddressString (150)Titkos másolat email cím.
channelMessageChannelA csatorna típusa.
xmlDataString (CLOB)Az üzenethez tartozó adatok XML formátumban.
certificationExpectedBooleantrue érték esetén a levél aláírásra kerül.
archivingExpectedBooleantrue esetén a levél tárgya és szövege archiválódik.
relatedMessageIdIntegerKapcsolódó üzenet Id.
campaignPartIdIntegerKampány rész azonosító id.
attachmentsJAttachment2 [ ]A csatolmányokat tartalmazó lista.A
propertiesJProperty1 [ ]Az üzenethez tartozó egyéb adatok, metaadatok.

A csatolmányokat további partokban lehet megadni, a part neve a csatolmány referenciája.

Válasz

NévTípusLeírás
messageIdIntegerAz aktuális levél adatbázisbeli azonosítója. (vnd.api ID)
metaJMeta1A válaszhoz tartozó metainformációk.

Minta

A lenti példa olyan emailre vonatkozik, amihez beküldött csatolmány tartozik. Ha csatolmány nélküli az email, akkor nem szükséges multipart üzenetet küldeni. Ebben az esetben a Content-Type header az 'application/vnd.api+json' vagy az 'application/json' valamelyike kell legyen, az üzenet body-ja pedig:

POST /hammy/json/send/v1/send?clientHashKey={{clientHashKey}}&userName={{userName}}
Authorization: JWT {{jwtToken}}
X-Client-Hash-Key: {{clientHashKey}}
X-User-Name: {{userName}}
content-type: multipart/form-data; boundary=-----------------------------{{boundary}}

-----------------------------{{boundary}}
Content-Disposition: form-data; name="message"
Content-Type: application/vnd.api+json

{
  "data" : {
    "type" : "sendRequests",
    "id" : "dfjhdsfk",
    "attributes" : {
      "mailSubject" : "Teszt",
      "mailBody" : "TesztTesztTeszt",
      "recipientAddress" : "cimzett.neve@valahol.hu",
      "recipientName" : "Dr. Címzett Neve",
      "fromAddress" : "felado@valahonnan.com",
      "fromName" : "Fel Adó"
    },
    "relationships" : {
      "properties" : {
        "data" : [ ]
      },
      "attachments" : {
        "data" : [ {
          "type" : "attachments",
          "id" : "1"
        } ]
      }
    }
  },
  "included" : [ {
    "type" : "attachments",
    "id" : "1",
    "attributes" : {
      "fileName" : "image.png",
      "internalFileName" : "internal-image.png",
      "archivingExpected" : true,
      "certificationExpected" : false,
      "contentAvailable" : false,
      "attachmentRef" : "{{attachmentPartNev}}",
      "deleteSourceExpected" : false,
      "postableWithoutCertificate" : false
    },
    "relationships" : {
      "properties" : {
        "data" : [ {
          "type" : "properties",
          "id" : "1"
        }, {
          "type" : "properties",
          "id" : "2"
        }, {
          "type" : "properties",
          "id" : "3"
        } ]
      }
    }
  }, {
    "type" : "properties",
    "id" : "3",
    "attributes" : {
      "key" : "ARCHIVE_RELATIVE_PATH",
      "value" : "/alma/",
      "isMetaData" : false
    }
  }, {
    "type" : "properties",
    "id" : "2",
    "attributes" : {
      "key" : "ARCHIVE_TARGET",
      "value" : "FS",
      "isMetaData" : false
    }
  }, {
    "type" : "properties",
    "id" : "1",
    "attributes" : {
      "key" : "ATTACHMENT_SOURCE",
      "value" : "INLINE",
      "isMetaData" : false
    }
  } ]
}
-----------------------------{{boundary}}
Content-Disposition: form-data; name="{{attachmentPartNev}}"
Content-Type: application/octet-stream

[BINÁRIS TARTALOM]
-----------------------------{{boundary}}

Queue API minta

Beállítások

AMQP-n keresztül is fogadjuk a kéréseket. Ebben az esetben az üzenet tulajdonságai között a következő értékek megadása szükséges:

content_type: [application/xml | application/json | application/vnd.api+json]

Az üzenet fejlécben pedig a következő értékek megadása szükséges:

X-Client-Hash-Key: {{clientHashKey}}
X-Method-Name:Send_V2_Send

Minta

A kérések és válaszok elvárt formátumát a content_type property vezérli.

application/json
Authorization: JWT {{jwtToken}}
X-Client-Hash-Key: {{clientHashKey}}
X-User-Name: {{userName}}
Content-Type: application/json

{
    "messageType": "351.DI",
    "recipientEmailAddress": "emailaddress@dbx.hu",
    "recipientName": "NAME",
    "attachments": [
        {
            "documentType": "351.DI",
            "fileName": "minta.pdf",
            "archivingExpected": "true",
            "certificationExpected": "false",
            "properties": [
                {
                    "isMetaData": "false",
                    "key": "ATTACHMENT_SOURCE",
                    "value": "FS"
                },
                {
                    "isMetaData": "false",
                    "key": "RELATIVE_FILE_PATH",
                    "value": "test.pdf"
                },
                {
                    "isMetaData": "false",
                    "key": "ARCHIVE_TARGET",
                    "value": "DMS"
                },
                {
                    "isMetaData": "true",
                    "key": "SZERZODO_NEVE",
                    "value": "Cserepes Virág"
                }
            ]
        }
    ],
    "properties": [
        {
            "isMetaData": "false",
            "key": "CIMZETT_NEVE",
            "value": "Teszt Elek"
        },
        {
            "isMetaData": "false",
            "key": "SZERZODES_AZON",
            "value": "123456789"
        },
        {
            "isMetaData": "false",
            "key": "NYOMT_AZON",
            "value": "351 díjértesítő"
        },
        {
            "isMetaData": "false",
            "key": "ROOT_ID",
            "value": "111111111"
        }
    ]
}
application/vnd.api+json
Authorization: JWT {{jwtToken}}
X-Client-Hash-Key: {{clientHashKey}}
X-User-Name: {{userName}}
Content-Type: application/vnd.api+json

{
    "data": {
        "type": "sendRequest",
        "id": "3ff0f9bb-80db-4e0f-a09c-7dac438e157f",
        "attributes": {
            "messageType": "351.DI",
            "recipientEmailAddress": "emailaddress@dbx.hu",
            "recipientName": "NAME"
        },
        "relationships": {
            "properties": {
                "data": [{
                        "type": "properties",
                        "id": "1"
                    },
                    {
                        "type": "properties",
                        "id": "2"
                    },
                    {
                        "type": "properties",
                        "id": "3"
                    },
                    {
                        "type": "properties",
                        "id": "4"
                    }
                ]
            },
            "attachments": {
                "data": [{
                    "type": "attachments",
                    "id": "1"
                }]
            }
        }
    },
    "included": [{
            "type": "attachments",
            "id": "1",
            "attributes": {
                "fileName": "minta.pdf",
                "documentType": "351.DI",
                "archivingExpected": "true",
                "certificationExpected": "false"
            },
            "relationships": {
                "properties": {
                    "data": [{
                            "type": "properties",
                            "id": "5"
                        },
                        {
                            "type": "properties",
                            "id": "6"
                        },
                        {
                            "type": "properties",
                            "id": "7"
                        },
                        {
                            "type": "properties",
                            "id": "8"
                        }
                    ]
                }
            }
        },
        {
            "type": "properties",
            "id": "1",
            "attributes": {
                "key": "CIMZETT_NEVE",
                "value": "Teszt Elek",
                "isMetaData": false
            }
        },
        {
            "type": "properties",
            "id": "2",
            "attributes": {
                "key": "SZERZODES_AZON",
                "value": "123456789",
                "isMetaData": false
            }
        },
        {
            "type": "properties",
            "id": "3",
            "attributes": {
                "key": "NYOMT_AZON",
                "value": "351 díjértesítő",
                "isMetaData": false
            }
        },
        {
            "type": "properties",
            "id": "4",
            "attributes": {
                "key": "ROOT_ID",
                "value": "111111111",
                "isMetaData": false
            }
        },
        {
            "type": "properties",
            "id": "5",
            "attributes": {
                "key": "ATTACHMENT_SOURCE",
                "value": "FS",
                "isMetaData": false
            }
        },
        {
            "type": "properties",
            "id": "6",
            "attributes": {
                "key": "RELATIVE_FILE_PATH",
                "value": "test.pdf",
                "isMetaData": false
            }
        },
        {
            "type": "properties",
            "id": "7",
            "attributes": {
                "key": "ARCHIVE_TARGET",
                "value": "DMS",
                "isMetaData": false
            }
        },
        {
            "type": "properties",
            "id": "8",
            "attributes": {
                "key": "SZERZODO_NEVE",
                "value": "Cserepes Virág",
                "isMetaData": true
            }
        }
    ]
}
application/xml
<sendMailRequest>
    <messageType>351.DI</messageType>
    <recipientEmailAddress>test@example.com</recipientEmailAddress>
    <recipientName>Teszt Elek</recipientName>
    <attachments>
        <attachment>
            <fileName>minta.pdf</fileName>
            <documentType>351.DI</documentType>
            <archivingExpected>true</archivingExpected>
            <certificationExpected>false</certificationExpected>
            <deleteSourceExpected>false</deleteSourceExpected>
            <postableWithoutCertificate>false</postableWithoutCertificate>
            <properties>
                <property>
                    <key>ATTACHMENT_SOURCE</key>
                    <value>FS</value>
                    <isMetaData>false</isMetaData>
                </property>
                <property>
                    <key>RELATIVE_FILE_PATH</key>
                    <value>test.pdf</value>
                    <isMetaData>false</isMetaData>
                </property>
                <property>
                    <key>ARCHIVE_TARGET</key>
                    <value>DMS</value>
                    <isMetaData>false</isMetaData>
                </property>
                <property>
                    <key>SZERZODO_NEVE</key>
                    <value>Cserepes Virág</value>
                    <isMetaData>true</isMetaData>
                </property>
            </properties>
        </attachment>
    </attachments>
    <properties>
        <property>
            <key>CIMZETT_NEVE</key>
            <value>Teszt Elek</value>
            <isMetaData>false</isMetaData>
        </property>
        <property>
            <key>SZERZODES_AZON</key>
            <value>123456789</value>
            <isMetaData>false</isMetaData>
        </property>
        <property>
            <key>NYOMT_AZON</key>
            <value>351 díjértesítő</value>
            <isMetaData>false</isMetaData>
        </property>
        <property>
            <key>ROOT_ID</key>
            <value>111111111</value>
            <isMetaData>false</isMetaData>
        </property>
    </properties>
</sendMailRequest>

Resend

Web service API

Ebben a verzióban nem változott.

Resend V1

REST API

Ebben a verzióban nem változott.

Resend V1

Queue

Queue-n keresztül is fogadjuk a kérést. Ez esetben a kötelező headerök a kérésnél:

Content-Type: application/xml
X-Client-Hash-Key: {{clientHashKey}}
X-Method-Name: Send_V2_Resend

Utoljára frissítve

Ezen az oldalon

Ági

Szia, Ági vagyok, miben segíthetek?

Ági

Szia, Ági vagyok, miben segíthetek?