템플릿 검수 가이드

curl "https://docs.almani-center.com/open/v1/templates/TPL_20260725143012" \
  -H "Authorization: Bearer ak_live_xxxx" \
  -H "X-Site-Id: 1024"

// Java 17 + Spring Framework 6 RestClient
RestClient restClient = RestClient.builder()
        .baseUrl("https://docs.almani-center.com/open/v1")
        .defaultHeader(HttpHeaders.AUTHORIZATION, "Bearer ak_live_xxxx")
        .defaultHeader("X-Site-Id", "1024")
        .build();

String response = restClient.get()
        .uri("/templates/{templateCode}", "TPL_20260725143012")
        .retrieve()
        .body(String.class);

HTTP/1.1 200 OK

{
  "code": "0000",
  "message": "OK",
  "data": {
    "templateCode": "TPL_20260725143012",
    "templateName": "주문완료 안내 v3",
    "approveStatus": "REJ",
    "rejectReason": "버튼 링크가 메시지 내용과 무관한 페이지로 연결됩니다. 주문 상세 페이지로 수정 후 재요청해 주세요.",
    "templateType": "BA",
    "category": "004001",
    "securityEnabled": false,
    "content": "#{고객명}님, 주문이 완료되었습니다.\n\n▶ 주문번호: #{주문번호}\n▶ 결제금액: #{결제금액}원\n\n배송이 시작되면 다시 알려드릴게요.",
    "buttons": [
      {
        "name": "주문 상세 보기",
        "type": "WL",
        "urlMobile": "https://event.example.com/summer"
      }
    ],
    "mappingData": {
      "고객명": "고객명",
      "주문번호": "주문번호",
      "결제금액": "결제금액"
    },
    "sendable": false,
    "recentHistory": [
      {
        "status": "REJ",
        "comment": "버튼 링크가 메시지 내용과 무관한 페이지로 연결됩니다. 주문 상세 페이지로 수정 후 재요청해 주세요.",
        "at": "2026-07-25T15:01:10+09:00"
      },
      {
        "status": "REQ",
        "comment": "주문 완료 시 발송되는 정보성 메시지입니다.",
        "at": "2026-07-25T14:30:12+09:00"
      }
    ]
  },
  "meta": {
    "requestId": "req_4c07d9b2",
    "quota": {
      "rateLimit": {
        "limit": 120,
        "remaining": 116,
        "resetAt": "2026-07-25T14:31:00+09:00"
      }
    }
  }
}

HTTP/1.1 404 Not Found

{
  "code": "4040",
  "message": "템플릿을 찾을 수 없습니다: TPL_20260725149999",
  "data": null,
  "meta": {
    "requestId": "req_b3e17a6d",
    "quota": {
      "rateLimit": {
        "limit": 120,
        "remaining": 115,
        "resetAt": "2026-07-25T14:31:00+09:00"
      }
    }
  }
}

curl "https://docs.almani-center.com/open/v1/templates/TPL_20260725143012/review-history" \
  -H "Authorization: Bearer ak_live_xxxx" \
  -H "X-Site-Id: 1024"

// Java 17 + Spring Framework 6 RestClient
RestClient restClient = RestClient.builder()
        .baseUrl("https://docs.almani-center.com/open/v1")
        .defaultHeader(HttpHeaders.AUTHORIZATION, "Bearer ak_live_xxxx")
        .defaultHeader("X-Site-Id", "1024")
        .build();

String response = restClient.get()
        .uri("/templates/{templateCode}/review-history", "TPL_20260725143012")
        .retrieve()
        .body(String.class);

HTTP/1.1 200 OK

{
  "code": "0000",
  "message": "OK",
  "data": {
    "items": [
      {
        "status": "REJ",
        "comment": "버튼 링크가 메시지 내용과 무관한 페이지로 연결됩니다. 주문 상세 페이지로 수정 후 재요청해 주세요.",
        "reviewer": "카카오",
        "at": "2026-07-25T15:01:10+09:00"
      },
      {
        "status": "REQ",
        "comment": "주문 완료 시 발송되는 정보성 메시지입니다.",
        "reviewer": null,
        "at": "2026-07-25T14:30:12+09:00"
      }
    ],
    "nextCursor": null
  },
  "meta": {
    "requestId": "req_38ab90fe",
    "quota": {
      "rateLimit": {
        "limit": 120,
        "remaining": 119,
        "resetAt": "2026-07-25T14:31:00+09:00"
      }
    }
  }
}

HTTP/1.1 404 Not Found

{
  "code": "4040",
  "message": "템플릿을 찾을 수 없습니다: TPL_20260725149999",
  "data": null,
  "meta": {
    "requestId": "req_f61b04d8",
    "quota": {
      "rateLimit": {
        "limit": 120,
        "remaining": 118,
        "resetAt": "2026-07-25T14:31:00+09:00"
      }
    }
  }
}

curl -X POST "https://docs.almani-center.com/open/v1/templates/TPL_20260725143012/review" \
  -H "Authorization: Bearer ak_live_xxxx" \
  -H "X-Site-Id: 1024" \
  -H "Idempotency-Key: 8c25d1b7-3e4f-4a90-b6c2-1d9e8f7a3c50" \
  -H "Content-Type: application/json" \
  -d '{
    "buttons": [
      {
        "name": "주문 상세 보기",
        "type": "WL",
        "urlMobile": "https://shop.example.com/orders/#{주문번호}"
      }
    ],
    "comments": "버튼 링크를 주문 상세 페이지로 수정했습니다."
  }'

// Java 17 + Spring Framework 6 RestClient
RestClient restClient = RestClient.builder()
        .baseUrl("https://docs.almani-center.com/open/v1")
        .defaultHeader(HttpHeaders.AUTHORIZATION, "Bearer ak_live_xxxx")
        .defaultHeader("X-Site-Id", "1024")
        .build();

record TemplateButton(String name, String type, String urlMobile) {}
record ReviewRequest(List<TemplateButton> buttons, String comments) {}

var request = new ReviewRequest(
        List.of(new TemplateButton("주문 상세 보기", "WL",
                "https://shop.example.com/orders/#{주문번호}")),
        "버튼 링크를 주문 상세 페이지로 수정했습니다.");

String response = restClient.post()
        .uri("/templates/{templateCode}/review", "TPL_20260725143012")
        .header("Idempotency-Key", UUID.randomUUID().toString())
        .contentType(MediaType.APPLICATION_JSON)
        .body(request)
        .retrieve()
        .body(String.class);

HTTP/1.1 200 OK

{
  "code": "0000",
  "message": "OK",
  "data": {
    "templateCode": "TPL_20260725143012",
    "approveStatus": "REQ",
    "requestedAt": "2026-07-25T15:12:03+09:00"
  },
  "meta": {
    "requestId": "req_d40a7c55",
    "quota": {
      "rateLimit": {
        "limit": 120,
        "remaining": 115,
        "resetAt": "2026-07-25T15:13:00+09:00"
      },
      "templateReview": {
        "dailyLimit": 30,
        "usedToday": 6,
        "remaining": 24,
        "resetAt": "2026-07-26T00:00:00+09:00"
      }
    }
  }
}

HTTP/1.1 409 Conflict

{
  "code": "4090",
  "message": "현재 상태(APR)에서는 검수를 요청할 수 없습니다. 재검수는 REG·REJ·UPT 상태에서만 가능합니다.",
  "data": null,
  "meta": {
    "requestId": "req_92c6e0af",
    "quota": {
      "rateLimit": {
        "limit": 120,
        "remaining": 114,
        "resetAt": "2026-07-25T15:13:00+09:00"
      }
    }
  }
}

curl -X POST "https://docs.almani-center.com/open/v1/templates/validate" \
  -H "Authorization: Bearer ak_live_xxxx" \
  -H "X-Site-Id: 1024" \
  -H "Content-Type: application/json" \
  -d '{
    "templateName": "여름 특가 안내",
    "templateType": "BA",
    "category": "004001",
    "content": "#{고객명}님, 지금 여름 특가 할인 중입니다!",
    "buttons": [
      {
        "name": "지금 확인하기",
        "type": "WL",
        "urlMobile": "https://event.example.com/summer"
      }
    ]
  }'

// Java 17 + Spring Framework 6 RestClient
RestClient restClient = RestClient.builder()
        .baseUrl("https://docs.almani-center.com/open/v1")
        .defaultHeader(HttpHeaders.AUTHORIZATION, "Bearer ak_live_xxxx")
        .defaultHeader("X-Site-Id", "1024")
        .build();

record TemplateButton(String name, String type, String urlMobile) {}
record ValidateRequest(
        String templateName, String templateType, String category,
        String content, List<TemplateButton> buttons) {}

var request = new ValidateRequest(
        "여름 특가 안내", "BA", "004001",
        "#{고객명}님, 지금 여름 특가 할인 중입니다!",
        List.of(new TemplateButton("지금 확인하기", "WL",
                "https://event.example.com/summer")));

String response = restClient.post()
        .uri("/templates/validate")
        .contentType(MediaType.APPLICATION_JSON)
        .body(request)
        .retrieve()
        .body(String.class);

HTTP/1.1 200 OK

{
  "code": "0000",
  "message": "OK",
  "data": {
    "valid": false,
    "violations": [
      {
        "severity": "ERROR",
        "rule": "AD_WORDING",
        "field": "content",
        "message": "'특가', '할인' 등 광고성 표현은 정보성 알림톡에서 반려 사유입니다."
      },
      {
        "severity": "WARN",
        "rule": "BUTTON_URL_MISMATCH",
        "field": "buttons[0].urlMobile",
        "message": "버튼 URL 도메인이 사이트 도메인과 다릅니다. 심사 지연 가능성이 있습니다."
      }
    ]
  },
  "meta": {
    "requestId": "req_e5c31d78",
    "quota": {
      "rateLimit": {
        "limit": 120,
        "remaining": 118,
        "resetAt": "2026-07-25T14:31:00+09:00"
      }
    }
  }
}

HTTP/1.1 400 Bad Request

{
  "code": "4000",
  "message": "templateType은 필수입니다.",
  "data": null,
  "meta": {
    "requestId": "req_17c95ab0",
    "quota": {
      "rateLimit": {
        "limit": 120,
        "remaining": 117,
        "resetAt": "2026-07-25T14:31:00+09:00"
      }
    }
  }
}

HTTP/1.1 200 OK

{
  "code": "0000",
  "message": "OK",
  "data": {
    "templateId": 5811,
    "templateCode": "TPL_20260725143012",
    "approveStatus": "REQ",
    "requestedAt": "2026-07-25T14:30:12+09:00"
  },
  "meta": {
    "requestId": "req_9f83ab21",
    "quota": {
      "rateLimit": {
        "limit": 120,
        "remaining": 117,
        "resetAt": "2026-07-25T14:31:00+09:00"
      },
      "templateReview": {
        "dailyLimit": 30,
        "usedToday": 5,
        "remaining": 25,
        "resetAt": "2026-07-26T00:00:00+09:00"
      }
    }
  }
}

HTTP/1.1 429 Too Many Requests

{
  "code": "4291",
  "message": "일일 템플릿 검수 요청 한도를 초과했습니다. 다음 날 자정 이후 다시 시도해 주세요.",
  "data": null,
  "meta": {
    "requestId": "req_66d1f0a3",
    "quota": {
      "rateLimit": {
        "limit": 120,
        "remaining": 116,
        "resetAt": "2026-07-25T14:31:00+09:00"
      },
      "templateReview": {
        "dailyLimit": 30,
        "usedToday": 30,
        "remaining": 0,
        "resetAt": "2026-07-26T00:00:00+09:00"
      }
    }
  }
}