빠른 시작 (3단계)

API 명세

요청 본문 (Request Body)

{
  "deposit_datetime": "06/02 11:35",
  "depositor_name": "홍길동",
  "amount": "70000"
}

응답 (Response)

서버는 처리 결과를 JSON으로 반환해야 하며, HTTP 상태 코드 200 + body의 status 필드가 "success"일 때만 성공으로 간주합니다.

{
  "status": "success",
  "message": "Data received successfully."
}

{
  "status": "error",
  "message": "Missing required data."
}

빠른 테스트

1) 무료 테스트 사이트로 즉시 확인

webhook.site 접속 → "Your unique URL" 복사 → 앱에 붙여넣고 저장. 입금 SMS 받으면 그 사이트에서 JSON이 도착하는 것을 실시간으로 확인 가능합니다.

2) 직접 curl로 테스트

curl -X POST https://your-server.example.com/webhook \
  -H "Content-Type: application/json" \
  -d '{"deposit_datetime":"06/02 11:35","depositor_name":"홍길동","amount":"70000"}'

언어별 수신 예제

아래는 노티페이가 보낸 JSON을 받아서 처리하는 최소 예제입니다.

PHP

 Copy<?php
header('Content-Type: application/json; charset=utf-8');

if ($_SERVER['REQUEST_METHOD'] !== 'POST') {
    http_response_code(405);
    echo json_encode(['status' => 'error', 'message' => 'POST only.']);
    exit;
}

// JSON Body 파싱
$raw = file_get_contents('php://input');
$data = json_decode($raw, true);

if (!is_array($data)
    || !isset($data['deposit_datetime'], $data['depositor_name'], $data['amount'])) {
    http_response_code(400);
    echo json_encode(['status' => 'error', 'message' => 'Missing required data.']);
    exit;
}

// === 여기서 본인 비즈니스 로직 처리 ===
//   $data['deposit_datetime']  : "06/02 11:35"
//   $data['depositor_name']    : "홍길동"
//   $data['amount']            : "70000"  (string, 숫자만)
// 예: DB 저장, 슬랙 알림, ERP 연동 등
// ====================================

http_response_code(200);
echo json_encode(['status' => 'success', 'message' => 'OK']);

Node.js (Express)

 Copyconst express = require('express');
const app = express();
app.use(express.json());

app.post('/webhook', (req, res) => {
    const { deposit_datetime, depositor_name, amount } = req.body || {};

    if (!deposit_datetime || !depositor_name || !amount) {
        return res.status(400).json({ status: 'error', message: 'Missing required data.' });
    }

    // 비즈니스 로직 (예: DB 저장)
    console.log(`입금: ${depositor_name} ${amount}원 @ ${deposit_datetime}`);

    res.status(200).json({ status: 'success', message: 'OK' });
});

app.listen(3000, () => console.log('listening on 3000'));

Python (표준 라이브러리)

 Copyimport json
from http.server import BaseHTTPRequestHandler, HTTPServer

class Handler(BaseHTTPRequestHandler):
    def do_POST(self):
        length = int(self.headers.get('Content-Length', 0))
        try:
            data = json.loads(self.rfile.read(length).decode('utf-8'))
        except json.JSONDecodeError:
            self._reply(400, {'status': 'error', 'message': 'Invalid JSON.'})
            return

        required = ('deposit_datetime', 'depositor_name', 'amount')
        if not all(k in data for k in required):
            self._reply(400, {'status': 'error', 'message': 'Missing required data.'})
            return

        # 비즈니스 로직
        print(f"입금: {data['depositor_name']} {data['amount']}원")

        self._reply(200, {'status': 'success', 'message': 'OK'})

    def _reply(self, code, body):
        self.send_response(code)
        self.send_header('Content-Type', 'application/json; charset=utf-8')
        self.end_headers()
        self.wfile.write(json.dumps(body).encode('utf-8'))

HTTPServer(('', 8000), Handler).serve_forever()

Python (Flask)

 Copyfrom flask import Flask, request, jsonify

app = Flask(__name__)

@app.route('/webhook', methods=['POST'])
def webhook():
    data = request.get_json(silent=True) or {}
    if not all(k in data for k in ('deposit_datetime', 'depositor_name', 'amount')):
        return jsonify(status='error', message='Missing required data.'), 400

    # 비즈니스 로직
    print(f"입금: {data['depositor_name']} {data['amount']}원")

    return jsonify(status='success', message='OK'), 200

if __name__ == '__main__':
    app.run(host='0.0.0.0', port=5000)

Java (Spring Boot)

 Copyimport org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;
import java.util.Map;

@RestController
public class WebhookController {

    @PostMapping("/webhook")
    public ResponseEntity<Map<String, String>> receive(@RequestBody Map<String, String> body) {
        String dt   = body.get("deposit_datetime");
        String name = body.get("depositor_name");
        String amt  = body.get("amount");

        if (dt == null || name == null || amt == null) {
            return ResponseEntity.badRequest().body(Map.of(
                "status", "error", "message", "Missing required data."
            ));
        }

        // 비즈니스 로직
        System.out.printf("입금: %s %s원%n", name, amt);

        return ResponseEntity.ok(Map.of("status", "success", "message", "OK"));
    }
}

C# (ASP.NET Core)

 Copyusing Microsoft.AspNetCore.Mvc;

public class DepositPayload {
    public string deposit_datetime { get; set; }
    public string depositor_name   { get; set; }
    public string amount           { get; set; }
}

[ApiController]
[Route("webhook")]
public class WebhookController : ControllerBase {
    [HttpPost]
    public IActionResult Receive([FromBody] DepositPayload p) {
        if (string.IsNullOrEmpty(p?.deposit_datetime)
            || string.IsNullOrEmpty(p.depositor_name)
            || string.IsNullOrEmpty(p.amount))
            return BadRequest(new { status = "error", message = "Missing required data." });

        // 비즈니스 로직
        Console.WriteLine($"입금: {p.depositor_name} {p.amount}원");

        return Ok(new { status = "success", message = "OK" });
    }
}

Go

 Copypackage main

import (
    "encoding/json"
    "fmt"
    "net/http"
)

type Payload struct {
    DepositDatetime string `json:"deposit_datetime"`
    DepositorName   string `json:"depositor_name"`
    Amount          string `json:"amount"`
}
type Resp struct {
    Status  string `json:"status"`
    Message string `json:"message"`
}

func handler(w http.ResponseWriter, r *http.Request) {
    w.Header().Set("Content-Type", "application/json; charset=utf-8")
    if r.Method != http.MethodPost {
        w.WriteHeader(http.StatusMethodNotAllowed)
        json.NewEncoder(w).Encode(Resp{"error", "POST only."})
        return
    }

    var p Payload
    if err := json.NewDecoder(r.Body).Decode(&p); err != nil ||
        p.DepositDatetime == "" || p.DepositorName == "" || p.Amount == "" {
        w.WriteHeader(http.StatusBadRequest)
        json.NewEncoder(w).Encode(Resp{"error", "Missing required data."})
        return
    }

    // 비즈니스 로직
    fmt.Printf("입금: %s %s원\n", p.DepositorName, p.Amount)

    w.WriteHeader(http.StatusOK)
    json.NewEncoder(w).Encode(Resp{"success", "OK"})
}

func main() {
    http.HandleFunc("/webhook", handler)
    http.ListenAndServe(":8080", nil)
}

Ruby (Sinatra)

 Copyrequire 'sinatra'
require 'json'

post '/webhook' do
  content_type :json
  data = JSON.parse(request.body.read) rescue {}

  unless %w[deposit_datetime depositor_name amount].all? { |k| data.key?(k) }
    status 400
    return { status: 'error', message: 'Missing required data.' }.to_json
  end

  # 비즈니스 로직
  puts "입금: #{data['depositor_name']} #{data['amount']}원"

  status 200
  { status: 'success', message: 'OK' }.to_json
end

JSP (Java)

 Copy<%@ page contentType="application/json; charset=UTF-8" %>
<%@ page import="java.io.*, org.json.JSONObject" %>
<%
    if (!"POST".equalsIgnoreCase(request.getMethod())) {
        response.setStatus(405);
        out.print(new JSONObject().put("status","error").put("message","POST only."));
        return;
    }

    StringBuilder sb = new StringBuilder();
    try (BufferedReader br = request.getReader()) {
        String line; while ((line = br.readLine()) != null) sb.append(line);
    }
    JSONObject data = new JSONObject(sb.toString());

    if (!data.has("deposit_datetime") || !data.has("depositor_name") || !data.has("amount")) {
        response.setStatus(400);
        out.print(new JSONObject().put("status","error").put("message","Missing required data."));
        return;
    }

    // 비즈니스 로직
    System.out.println("입금: " + data.getString("depositor_name") + " " + data.getString("amount") + "원");

    response.setStatus(200);
    out.print(new JSONObject().put("status","success").put("message","OK"));
%>

모범 사례 (Best Practices)

• HTTPS 사용 — HTTP는 권장하지 않습니다. SSL 무료 발급(Let's Encrypt) 활용.
• 중복 처리 방지 — 같은 입금이 여러 번 들어와도 한 번만 처리하도록 (예: depositor + amount + datetime 조합으로 dedupe key 생성).
• 응답은 즉시 — 비즈니스 로직을 큐에 넣고 응답은 바로 200 반환 (앱 timeout 30초). 무거운 처리는 백그라운드에서.
• 로그 보관 — 받은 raw payload를 일정 기간 저장하면 디버깅에 도움됩니다.
• 인증 추가 — 외부에 URL이 노출되므로 secret token을 URL 쿼리스트링이나 Header로 추가하면 안전합니다 (예: ?token=abc123).

자주 묻는 질문