{
  "openapi": "3.0.3",
  "info": {
    "title": "SENDLIVE Kakao API",
    "version": "1.0.0",
    "description": "2026-11-18 운영 코드 기준. 서버 간 연동 전용. 발송 접수와 최종 수신은 다릅니다. 단건 결과 행, 대량 개인별 변수, 멱등성, 원자적 잔액 처리에는 제한이 있습니다. API 가이드를 먼저 확인하세요."
  },
  "servers": [
    {
      "url": "https://kakakapi.sendlive.kr/api/v1"
    }
  ],
  "security": [
    {
      "ApiKey": [],
      "ApiSecret": []
    }
  ],
  "components": {
    "securitySchemes": {
      "ApiKey": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      },
      "ApiSecret": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Secret"
      }
    }
  },
  "paths": {
    "/balance": {
      "get": {
        "summary": "잔액 조회",
        "description": "해당 클라이언트의 잔액입니다. 실제 계약 요금표가 아닙니다.",
        "responses": {
          "200": {
            "description": "응답 본문의 success와 상태를 함께 확인",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "clientId": {
                      "type": "string",
                      "format": "uuid"
                    },
                    "clientName": {
                      "type": "string"
                    },
                    "alimtalkBalance": {
                      "type": "number"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "인증 헤더 누락 또는 잘못된 키",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "비활성 클라이언트",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "서버 오류. 변경 요청 자동 재시도 금지",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/profiles/token": {
      "post": {
        "summary": "채널 인증번호 요청",
        "description": "채널 관리자 휴대폰으로 실제 인증번호가 발송됩니다.",
        "responses": {
          "200": {
            "description": "응답 본문의 success와 상태를 함께 확인",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean"
                    },
                    "message": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "인증 헤더 누락 또는 잘못된 키",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "비활성 클라이언트",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "서버 오류. 변경 요청 자동 재시도 금지",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "yellowId": {
                    "type": "string"
                  },
                  "phoneNumber": {
                    "type": "string"
                  }
                },
                "required": [
                  "yellowId",
                  "phoneNumber"
                ]
              }
            }
          }
        }
      }
    },
    "/profiles": {
      "get": {
        "summary": "발신 프로필 목록",
        "description": "인증한 클라이언트 소유의 프로필만 조회합니다.",
        "responses": {
          "200": {
            "description": "응답 본문의 success와 상태를 함께 확인",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "profiles": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "format": "uuid"
                          },
                          "sender_key": {
                            "type": "string"
                          },
                          "channel_id": {
                            "type": "string"
                          },
                          "channel_name": {
                            "type": "string"
                          },
                          "phone_number": {
                            "type": "string"
                          },
                          "category_code": {
                            "type": "string"
                          },
                          "status": {
                            "type": "string"
                          },
                          "is_default": {
                            "type": "boolean"
                          },
                          "created_at": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "인증 헤더 누락 또는 잘못된 키",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "비활성 클라이언트",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "서버 오류. 변경 요청 자동 재시도 금지",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      },
      "post": {
        "summary": "발신 프로필 등록",
        "description": "관리자가 제공한 카테고리 코드와 휴대폰 인증번호가 필요합니다.",
        "responses": {
          "200": {
            "description": "응답 본문의 success와 상태를 함께 확인",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean"
                    },
                    "profileId": {
                      "type": "string",
                      "format": "uuid"
                    },
                    "senderKey": {
                      "type": "string"
                    },
                    "channelName": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "인증 헤더 누락 또는 잘못된 키",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "비활성 클라이언트",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "서버 오류. 변경 요청 자동 재시도 금지",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "yellowId": {
                    "type": "string"
                  },
                  "phoneNumber": {
                    "type": "string"
                  },
                  "token": {
                    "type": "string"
                  },
                  "categoryCode": {
                    "type": "string"
                  }
                },
                "required": [
                  "yellowId",
                  "phoneNumber",
                  "token",
                  "categoryCode"
                ]
              }
            }
          }
        }
      }
    },
    "/templates": {
      "get": {
        "summary": "템플릿 목록",
        "description": "sender_profile_id와 inspection_status=approved를 확인한 뒤 발송하세요.",
        "responses": {
          "200": {
            "description": "응답 본문의 success와 상태를 함께 확인",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "templates": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "format": "uuid"
                          },
                          "templateId": {
                            "type": "string",
                            "format": "uuid"
                          },
                          "sender_profile_id": {
                            "type": "string",
                            "format": "uuid"
                          },
                          "template_code": {
                            "type": "string"
                          },
                          "template_name": {
                            "type": "string"
                          },
                          "content": {
                            "type": "string"
                          },
                          "buttons": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "name": {
                                  "type": "string"
                                },
                                "linkType": {
                                  "type": "string"
                                },
                                "linkMo": {
                                  "type": "string"
                                },
                                "linkPc": {
                                  "type": "string"
                                }
                              }
                            }
                          },
                          "inspection_status": {
                            "type": "string",
                            "enum": [
                              "pending",
                              "approved",
                              "rejected",
                              "returned"
                            ]
                          },
                          "status": {
                            "type": "string"
                          },
                          "inspectionStatus": {
                            "type": "string"
                          },
                          "rejection_reason": {
                            "type": "string",
                            "nullable": true
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "인증 헤더 누락 또는 잘못된 키",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "비활성 클라이언트",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "서버 오류. 변경 요청 자동 재시도 금지",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      },
      "post": {
        "summary": "템플릿 검수 등록",
        "description": "등록 성공은 검수 승인과 다릅니다. 서버 등록 성공 후 DB 저장에 실패한 경우 자동 재등록하지 마세요.",
        "responses": {
          "200": {
            "description": "응답 본문의 success와 상태를 함께 확인",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean"
                    },
                    "templateId": {
                      "type": "string",
                      "format": "uuid"
                    },
                    "templateCode": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "인증 헤더 누락 또는 잘못된 키",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "비활성 클라이언트",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "서버 오류. 변경 요청 자동 재시도 금지",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "profileId": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "templateName": {
                    "type": "string"
                  },
                  "templateContent": {
                    "type": "string"
                  },
                  "categoryCode": {
                    "type": "string"
                  },
                  "templateMessageType": {
                    "type": "string",
                    "default": "BA"
                  },
                  "templateEmphasizeType": {
                    "type": "string",
                    "default": "NONE"
                  },
                  "templateExtra": {
                    "type": "string"
                  },
                  "buttons": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string"
                        },
                        "linkType": {
                          "type": "string"
                        },
                        "linkMo": {
                          "type": "string"
                        },
                        "linkPc": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "required": [
                  "profileId",
                  "templateName",
                  "templateContent",
                  "categoryCode"
                ]
              }
            }
          }
        }
      }
    },
    "/templates/sync": {
      "post": {
        "summary": "검수 상태 동기화",
        "description": "최대 200건 검사. errors 배열도 확인하세요.",
        "responses": {
          "200": {
            "description": "응답 본문의 success와 상태를 함께 확인",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean"
                    },
                    "scanned": {
                      "type": "integer"
                    },
                    "updated": {
                      "type": "integer"
                    },
                    "errors": {
                      "type": "array",
                      "items": {}
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "인증 헤더 누락 또는 잘못된 키",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "비활성 클라이언트",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "서버 오류. 변경 요청 자동 재시도 금지",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/fixed-templates": {
      "get": {
        "summary": "정산서·독촉 기본 양식",
        "description": "공통 양식이며 이 ID로 바로 발송할 수 없습니다. 클라이언트 채널 등록과 승인이 필요합니다.",
        "responses": {
          "200": {
            "description": "응답 본문의 success와 상태를 함께 확인",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "templates": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "format": "uuid"
                          },
                          "template_key": {
                            "type": "string"
                          },
                          "template_name": {
                            "type": "string"
                          },
                          "content": {
                            "type": "string"
                          },
                          "variables": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "buttons": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "name": {
                                  "type": "string"
                                },
                                "linkType": {
                                  "type": "string"
                                },
                                "linkMo": {
                                  "type": "string"
                                },
                                "linkPc": {
                                  "type": "string"
                                }
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "인증 헤더 누락 또는 잘못된 키",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "비활성 클라이언트",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "서버 오류. 변경 요청 자동 재시도 금지",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/shop-fixed-templates": {
      "get": {
        "summary": "상점용 공통 양식",
        "description": "승인 템플릿과 구분하세요. 별도 등록과 승인이 필요합니다.",
        "responses": {
          "200": {
            "description": "응답 본문의 success와 상태를 함께 확인",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "templates": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "format": "uuid"
                          },
                          "template_key": {
                            "type": "string"
                          },
                          "template_name": {
                            "type": "string"
                          },
                          "content": {
                            "type": "string"
                          },
                          "variables": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "buttons": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "name": {
                                  "type": "string"
                                },
                                "linkType": {
                                  "type": "string"
                                },
                                "linkMo": {
                                  "type": "string"
                                },
                                "linkPc": {
                                  "type": "string"
                                }
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "인증 헤더 누락 또는 잘못된 키",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "비활성 클라이언트",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "서버 오류. 변경 요청 자동 재시도 금지",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/send": {
      "post": {
        "summary": "알림톡 발송",
        "description": "실제 발송과 잔액 차감이 발생합니다. 중복 전화번호는 제거합니다. 1명은 동기, 2명 이상은 비동기 처리합니다. 대량 수신자별 variables는 현재 보존되지 않습니다. 멱등성을 제공하지 않으므로 POST 자동 재시도 금지. 같은 클라이언트는 순차 호출하세요.",
        "responses": {
          "200": {
            "description": "응답 본문의 success와 상태를 함께 확인",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean"
                    },
                    "requestId": {
                      "type": "string",
                      "format": "uuid"
                    },
                    "total": {
                      "type": "integer"
                    },
                    "sent": {
                      "type": "integer"
                    },
                    "failed": {
                      "type": "integer"
                    },
                    "balance": {
                      "type": "number"
                    },
                    "message": {
                      "type": "string"
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "필수 입력 누락 또는 유효한 수신번호 없음",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "인증 헤더 누락 또는 잘못된 키",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "402": {
            "description": "잔액 부족",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "비활성 클라이언트",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "프로필/템플릿이 없거나 다른 클라이언트 소유",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "대량 발송 진행 중",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "서버 오류. 변경 요청 자동 재시도 금지",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "profileId": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "templateId": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "recipients": {
                    "type": "array",
                    "minItems": 1,
                    "items": {
                      "type": "object",
                      "properties": {
                        "phone": {
                          "type": "string"
                        },
                        "name": {
                          "type": "string"
                        },
                        "variables": {
                          "type": "object",
                          "additionalProperties": {
                            "type": "string"
                          },
                          "description": "단건 본문 #{변수명} 치환. 대량 경로는 지원하지 않음."
                        }
                      },
                      "required": [
                        "phone"
                      ]
                    }
                  }
                },
                "required": [
                  "profileId",
                  "templateId",
                  "recipients"
                ]
              }
            }
          }
        }
      }
    },
    "/send/{requestId}/progress": {
      "parameters": [
        {
          "name": "requestId",
          "in": "path",
          "required": true,
          "schema": {
            "type": "string",
            "format": "uuid"
          }
        }
      ],
      "get": {
        "summary": "진행 상태 조회",
        "description": "접수 성공은 최종 수신 성공과 다릅니다. 단건은 resultStats가 0일 수 있습니다.",
        "responses": {
          "200": {
            "description": "응답 본문의 success와 상태를 함께 확인",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "requestId": {
                      "type": "string",
                      "format": "uuid"
                    },
                    "status": {
                      "type": "string"
                    },
                    "totalCount": {
                      "type": "integer"
                    },
                    "batchProgress": {
                      "type": "integer"
                    },
                    "successCount": {
                      "type": "integer"
                    },
                    "failCount": {
                      "type": "integer"
                    },
                    "createdAt": {
                      "type": "string"
                    },
                    "completedAt": {
                      "type": "string",
                      "nullable": true
                    },
                    "resultStats": {
                      "type": "object",
                      "properties": {
                        "pending": {
                          "type": "integer"
                        },
                        "sent": {
                          "type": "integer"
                        },
                        "delivered": {
                          "type": "integer"
                        },
                        "failed": {
                          "type": "integer"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "인증 헤더 누락 또는 잘못된 키",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "비활성 클라이언트",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "서버 오류. 변경 요청 자동 재시도 금지",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/send/{requestId}/results": {
      "parameters": [
        {
          "name": "requestId",
          "in": "path",
          "required": true,
          "schema": {
            "type": "string",
            "format": "uuid"
          }
        },
        {
          "name": "limit",
          "in": "query",
          "schema": {
            "type": "integer",
            "default": 50,
            "minimum": 1
          }
        },
        {
          "name": "offset",
          "in": "query",
          "schema": {
            "type": "integer",
            "default": 0,
            "minimum": 0
          }
        },
        {
          "name": "status",
          "in": "query",
          "schema": {
            "type": "string",
            "enum": [
              "pending",
              "sent",
              "delivered",
              "failed"
            ]
          }
        }
      ],
      "get": {
        "summary": "수신자별 결과",
        "description": "단건 경로는 결과 행이 없어 빈 목록일 수 있습니다. 수신번호 개인정보 취급에 주의하세요.",
        "responses": {
          "200": {
            "description": "응답 본문의 success와 상태를 함께 확인",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "results": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "format": "uuid"
                          },
                          "receiver_phone": {
                            "type": "string"
                          },
                          "receiver_name": {
                            "type": "string",
                            "nullable": true
                          },
                          "send_code": {
                            "type": "string",
                            "nullable": true
                          },
                          "status": {
                            "type": "string",
                            "enum": [
                              "pending",
                              "sent",
                              "delivered",
                              "failed"
                            ]
                          },
                          "error_code": {
                            "type": "string",
                            "nullable": true
                          },
                          "error_message": {
                            "type": "string",
                            "nullable": true
                          },
                          "result_code": {
                            "type": "string",
                            "nullable": true
                          },
                          "result_message": {
                            "type": "string",
                            "nullable": true
                          },
                          "report_time": {
                            "type": "string",
                            "nullable": true
                          },
                          "sent_at": {
                            "type": "string",
                            "nullable": true
                          }
                        }
                      }
                    },
                    "total": {
                      "type": "integer"
                    },
                    "limit": {
                      "type": "integer"
                    },
                    "offset": {
                      "type": "integer"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "인증 헤더 누락 또는 잘못된 키",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "비활성 클라이언트",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "서버 오류. 변경 요청 자동 재시도 금지",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
