알림톡

curl -X POST "https://mars.ibapi.kr/api/comm/v1/send/omni" \
  -H "Authorization: {ApiKey}" \
  -H "Content-Type: application/json" \
  -d '{
    "destinations": [{
      "to": "01000000000",
      "replaceWords": {
        "name": "홍길동",
        "orderName": "비즈고 이용권",
        "status": "결제완료"
      }
    }],
    "messageFlow": [{
      "alimtalk": {
        "senderKey": "{senderKey}",
        "templateCode": "{templateCode}",
        "sendType": "template"
      }
    }],
    "ref": "alimtalk-template-001"
  }'

const res = await fetch("https://mars.ibapi.kr/api/comm/v1/send/omni", {
  method: "POST",
  headers: {
    "Authorization": "{ApiKey}",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    destinations: [{
      to: "01000000000",
      replaceWords: { name: "홍길동", orderName: "비즈고 이용권", status: "결제완료" }
    }],
    messageFlow: [{
      alimtalk: { senderKey: "{senderKey}", templateCode: "{templateCode}", sendType: "template" }
    }],
    ref: "alimtalk-template-001"
  })
});

import requests

response = requests.post(
    "https://mars.ibapi.kr/api/comm/v1/send/omni",
    headers={"Authorization": "{ApiKey}"},
    json={
        "destinations": [{"to": "01000000000", "replaceWords": {"name": "홍길동", "orderName": "비즈고 이용권", "status": "결제완료"}}],
        "messageFlow": [{"alimtalk": {"senderKey": "{senderKey}", "templateCode": "{templateCode}", "sendType": "template"}}],
        "ref": "alimtalk-template-001"
    }
)
data = response.json()

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://mars.ibapi.kr/api/comm/v1/send/omni"))
    .header("Authorization", "{ApiKey}")
    .method("POST", HttpRequest.BodyPublishers.ofString("{}"))
    .build();

HttpResponse<String> response = client.send(
    request, HttpResponse.BodyHandlers.ofString()
);

{
  "common": {
    "authCode": "A000",
    "authResult": "Success",
    "infobankTrId": "Infobank-Tracking-Id"
  },
  "data": {
    "code": "A000",
    "result": "Success",
    "data": {
      "destinations": [{
        "to": "01000000000",
        "msgKey": "AT20260408-000001",
        "code": "A000",
        "result": "Success"
      }]
    },
    "ref": "alimtalk-template-001"
  }
}

curl -X GET "https://mars.ibapi.kr/api/comm/v1/center/alimtalk/template?senderKey={senderKey}&templateCode={templateCode}" \
  -H "Authorization: {ApiKey}"

const res = await fetch("https://mars.ibapi.kr/api/comm/v1/center/alimtalk/template?senderKey={senderKey}&templateCode={templateCode}", {
  method: "GET",
  headers: { "Authorization": "{ApiKey}" }
});

import requests

response = requests.get(
    "https://mars.ibapi.kr/api/comm/v1/center/alimtalk/template",
    params={"senderKey": "{senderKey}", "templateCode": "{templateCode}"},
    headers={"Authorization": "{ApiKey}"}
)
data = response.json()

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://mars.ibapi.kr/api/comm/v1/center/alimtalk/template?senderKey={senderKey}&templateCode={templateCode}"))
    .header("Authorization", "{ApiKey}")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

{
  "common": {
    "authCode": "A000",
    "authResult": "Success",
    "infobankTrId": "Infobank-Tracking-Id"
  },
  "data": {
    "code": "A000",
    "result": "Success",
    "data": {
      "alimtalk": {
        "senderKey": "{senderKey}",
        "templateCode": "{templateCode}",
        "text": "#{name}님, 주문이 완료되었습니다."
      }
    }
  }
}

curl -X GET "https://mars.ibapi.kr/api/comm/v1/center/alimtalk/template/lastModified?senderKey={senderKey}&senderKeyType=S&since=2026-04-23T09:00:00&page=1&count=100" \
  -H "Authorization: {ApiKey}"

const res = await fetch("https://mars.ibapi.kr/api/comm/v1/center/alimtalk/template/lastModified?senderKey={senderKey}&senderKeyType=S&since=2026-04-23T09:00:00&page=1&count=100", {
  method: "GET",
  headers: { "Authorization": "{ApiKey}" }
});

import requests

response = requests.get(
    "https://mars.ibapi.kr/api/comm/v1/center/alimtalk/template/lastModified",
    params={"senderKey": "{senderKey}", "senderKeyType": "S", "since": "2026-04-23T09:00:00", "page": 1, "count": 100},
    headers={"Authorization": "{ApiKey}"}
)
data = response.json()

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://mars.ibapi.kr/api/comm/v1/center/alimtalk/template/lastModified?senderKey={senderKey}&senderKeyType=S&since=2026-04-23T09:00:00&page=1&count=100"))
    .header("Authorization", "{ApiKey}")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

{
  "common": {
    "authCode": "A000",
    "authResult": "Success",
    "infobankTrId": "Infobank-Tracking-Id"
  },
  "data": {
    "code": "A000",
    "result": "Success",
    "data": {
      "alimtalk": {
        "templates": [{
          "senderKey": "{senderKey}",
          "msgType": "AT",
          "templateCode": "ORDER_DONE_001",
          "templateName": "주문 완료 안내",
          "templateMessageType": "BA",
          "templateEmphasizeType": "NONE",
          "text": "#{name}님, 주문이 완료되었습니다.",
          "categoryCode": "001001",
          "inspectionStatus": "APR",
          "status": "APR"
        }]
      }
    }
  }
}