템플릿 추가

Request

POST https://api.coolsms.co.kr/kakao/v1/templates

템플릿을 새롭게 등록합니다.

Authorization 인증 필요 [?]

계정 권한	회원 권한	계정 상태	회원 상태	계정 인증
kakao:write	role-kakao:write	ACTIVE	ACTIVE	O

Request Structure

{
    "pfId": "string",
    "name": "string",
    "content": "string",
    "buttons": "array"
}

Body Params

Name	Type	Required	Description
pfId	string	O	카카오톡채널 고유 아이디
name	string	O	이름
content	string	O	템플릿 내용
buttons	array		템플릿에 들어가는 버튼들

Body / buttons

Name	Type	Required	Description
buttonType	string	O	설명 없음
buttonName	string	O	설명 없음
linkMo	string		Mobile 주소
linkPc	string		PC 주소
linkAnd	string		Android 주소
linkIos	string		IOS 주소

Samples

템플릿 등록

Sample Request

{
    "pfId": "PF01ID210129012914478ZRQ3mr...",
    "name": "회원가입",
    "content": "#{홍길동}님 회원가입을 환영 합니다."
}

Sample Response

{
    "isHidden": false,
    "name": "회원가입",
    "pfId": "PF01ID210129012914478ZRQ3mrGoR8n",
    "accountId": "12925149",
    "buttons": [],
    "codes": [
        {
            "status": "PENDING",
            "service": "biz",
            "comments": []
        }
    ],
    "content": "#{홍길동}님 회원가입을 환영 합니다.",
    "dateCreated": "2021-01-29T01:29:15.333Z",
    "dateUpdated": "2021-01-29T01:29:15.333Z",
    "templateId": "KA01TP2101290129153361LAHOSycWm7"
}

Sample Code

NODE

var request = require('request');

var options = {
  headers: {
    Authorization:
      'HMAC-SHA256 apiKey=NCSAYU7YDBXYORXC, date=2019-07-01T00:41:48Z, salt=jqsba2jxjnrjor, signature=1779eac71a24cbeeadfa7263cb84b7ea0af1714f5c0270aa30ffd34600e363b4',
    'Content-Type': 'application/json'
  },
  body: {
    pfId: 'PF01ID210129012914478ZRQ3mr...',
    name: '회원가입',
    content: '#{홍길동}님 회원가입을 환영 합니다.'
  },
  method: 'POST',
  json: true,
  url: 'http://api.coolsms.co.kr/kakao/v1/templates'
};

request(options, function(error, response, body) {
  if (error) throw error;
  console.log('result :', body);
});

PHP

<?php
$url = "http://api.coolsms.co.kr/kakao/v1/templates";
$data = '{"pfId":"PF01ID210129012914478ZRQ3mr...","name":"회원가입","content":"#{홍길동}님 회원가입을 환영 합니다."}';

$options = array(
    'http' => array(
        'header'  => "Authorization: HMAC-SHA256 apiKey=NCSAYU7YDBXYORXC, date=2019-07-01T00:41:48Z, salt=jqsba2jxjnrjor, signature=1779eac71a24cbeeadfa7263cb84b7ea0af1714f5c0270aa30ffd34600e363b4\r\n" . "Content-Type: application/json\r\n",
        'content' => $data,
        'method'  => 'POST'
    )
);

$context  = stream_context_create($options);
$result = file_get_contents($url, false, $context);

var_dump($result);

PYTHON

import requests

url = "http://api.coolsms.co.kr/kakao/v1/templates"
headers = {
  "Authorization": "HMAC-SHA256 apiKey=NCSAYU7YDBXYORXC, date=2019-07-01T00:41:48Z, salt=jqsba2jxjnrjor, signature=1779eac71a24cbeeadfa7263cb84b7ea0af1714f5c0270aa30ffd34600e363b4",
  "Content-Type": "application/json"
}
data = '{"pfId":"PF01ID210129012914478ZRQ3mr...","name":"회원가입","content":"#{홍길동}님 회원가입을 환영 합니다."}'

response = requests.post(url, headers=headers, data=data)
print(response.status_code)
print(response.text)

CURL

#!/bin/bash
curl -X POST \
    -H 'Authorization: HMAC-SHA256 apiKey=NCSAYU7YDBXYORXC, date=2019-07-01T00:41:48Z, salt=jqsba2jxjnrjor, signature=1779eac71a24cbeeadfa7263cb84b7ea0af1714f5c0270aa30ffd34600e363b4' \
    -H 'Content-Type: application/json' \
    -d '{"pfId":"PF01ID210129012914478ZRQ3mr...","name":"회원가입","content":"#{홍길동}님 회원가입을 환영 합니다."}' \
    http://api.coolsms.co.kr/kakao/v1/templates

RUBY

require 'net/http'
require 'uri'
require 'json'

uri = URI.parse("http://api.coolsms.co.kr/kakao/v1/templates")

headers = {
  "Authorization": "HMAC-SHA256 apiKey=NCSAYU7YDBXYORXC, date=2019-07-01T00:41:48Z, salt=jqsba2jxjnrjor, signature=1779eac71a24cbeeadfa7263cb84b7ea0af1714f5c0270aa30ffd34600e363b4",
  "Content-Type": "application/json"
}
data = {
  "pfId": "PF01ID210129012914478ZRQ3mr...",
  "name": "회원가입",
  "content": "#{홍길동}님 회원가입을 환영 합니다."
}
http = Net::HTTP.new(uri.host, uri.port)
request = Net::HTTP::Post.new(uri.request_uri, headers)
request.body = data.to_json

response = http.request(request)
puts response.code
puts response.body

GO

package main

import (
  "fmt"
  "io/ioutil"
  "net/http"
  "strings"
)

func main() {
  uri := "http://api.coolsms.co.kr/kakao/v1/templates"
  data := strings.NewReader(`{"pfId":"PF01ID210129012914478ZRQ3mr...","name":"회원가입","content":"#{홍길동}님 회원가입을 환영 합니다."}`)

  req, err := http.NewRequest("POST", uri, data)
  if err != nil { panic(err) }

  req.Header.Set("Authorization", "HMAC-SHA256 apiKey=NCSAYU7YDBXYORXC, date=2019-07-01T00:41:48Z, salt=jqsba2jxjnrjor, signature=1779eac71a24cbeeadfa7263cb84b7ea0af1714f5c0270aa30ffd34600e363b4")
  req.Header.Set("Content-Type", "application/json")

  client := &http.Client{}
  resp, err := client.Do(req)
  if err != nil { panic(err) }
  defer resp.Body.Close()

  bytes, _ := ioutil.ReadAll(resp.Body)
  str := string(bytes)
  fmt.Println(str)
}

JAVA

package solapi;

import java.io.BufferedReader;
import java.io.DataOutputStream;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;

public class Request {
  public static void main(String[] args) throws Exception {
    String targetUrl = "http://api.coolsms.co.kr/kakao/v1/templates";
    String parameters = "{\"pfId\":\"PF01ID210129012914478ZRQ3mr...\",\"name\":\"회원가입\",\"content\":\"#{홍길동}님 회원가입을 환영 합니다.\"}";

    URL url = new URL(targetUrl);
    HttpURLConnection con = (HttpURLConnection) url.openConnection();

    con.setRequestMethod("POST");

    con.setRequestProperty("Authorization", "HMAC-SHA256 apiKey=NCSAYU7YDBXYORXC, date=2019-07-01T00:41:48Z, salt=jqsba2jxjnrjor, signature=1779eac71a24cbeeadfa7263cb84b7ea0af1714f5c0270aa30ffd34600e363b4");
    con.setRequestProperty("Content-Type", "application/json");

    con.setDoOutput(true);
    DataOutputStream wr = new DataOutputStream(con.getOutputStream());
    wr.writeBytes(parameters);
    wr.flush();
    wr.close();

    int responseCode = con.getResponseCode();
    BufferedReader in = new BufferedReader(new InputStreamReader(con.getInputStream()));
    String line;
    StringBuffer response = new StringBuffer();
    while ((line = in.readLine()) != null) {
      response.append(line);
    }
    in.close();

    System.out.println("HTTP response code : " + responseCode);
    System.out.println("HTTP body : " + response.toString());
  }
}

문서 생성일 : 2021-01-29