뱃지 디자인 다건조회

뱃지 디자인 다건 조회 (GET)

뱃지 디자인 목록을 조회합니다.

• Method: GET

• URL: /badge-designs

• Query Parameters:

  파라미터	타입	필수	기본값	설명
  page	number	No	1	조회할 페이지 번호
  pageSize	number	No	15	페이지 당 항목 수

---

Response

{
  "statusCode": 200,
  "message": "뱃지 디자인 리스트가 조회되었습니다.",
  "badgeDesigns": [
    {
      "id": 83,
      "name": "Template Design A",
      "main_color": "#2e6227",
       "sub_color": "#d4e45e",
       "extra_color_1": "#000000",
       "extra_color_2": "#000000",
       "layout_json": [
         {
           "id": "image-5497",
           "controlType": "image",
           "designType": "image",
           "src": "https://...",
           "background": "transparent",
           "width": 600,
           "height": 600,
           "x": 0,
           "y": 0,
           "order": 1
         },...
       ],
      "template_type": "NewBadgeTypeEmpty",
       "created_at": "2025-04-09T18:37:39.696Z",
       "updated_at": "2025-04-09T18:37:39.696Z"
    },
    ....
  ],
  "totalPages": 5
}

badgeDesigns (object[])

필드명	타입	설명
id	number	badge 디자인 고유 id
name	string	badge 디자인 이름
main_color	string | null	메인 색상 메인 색상 (Hex 코드)
sub_color	string | null	서브 색상
extra_color_1	string | null	추가 색상1
extra_color_2	string | null	추가 색상2
template_type	string	템플릿 타입
layout_json	object[]	인증서 이미지 생성을 위한 디자인 JSON 배열
created_at	string (ISO8601)	badge 디자인 생성일
updated_at	string (ISO8601)	badge 디자인 수정일

---

오류 코드

상태 코드	에러	메시지	상세 설명
400	Bad Request	Page must not be less than 1, Page must be a positive number	페이지 타입이 올바르지 않은 경우
400	Bad Request	PageSize must not be less than 1, PageSize must be a positive number	페이지 사이즈 타입이 올바르지 않은 경우
401	Unauthorized	Invalid token	인증 정보가 올바르지 않은 경우
404	Not Found	뱃지 디자인 리스트를 찾을 수 없습니다.	해당 클럽 도메인의 디자인 데이터가 없을 경우
500	Internal Server Error	예기치 않은 오류가 발생했습니다.	서버 에러

Request Sample

Java

Unirest

String url = "https://api.test.kolleges.net/open-api/badge-designs";

HttpResponse<String> response = Unirest.get(url + queryParams)
    .header("Content-Type", "application/json")
    .header("Accept", "application/json")
    .header("Authorization", "Bearer " + apiKey)
    .asString();

System.out.println("Status: " + response.getStatus());
System.out.println("Response: " + response.getBody());

OkHttp

OkHttpClient client = new OkHttpClient();
String baseUrl = "https://api.test.kolleges.net/open-api/badge-designs";
String url = baseUrl + queryParams;

Request request = new Request.Builder()
    .url(url)
    .addHeader("Content-Type", "application/json")
    .addHeader("Accept", "application/json")
    .addHeader("Authorization", "Bearer " + apiKey)
    .build();

try (Response response = client.newCall(request).execute()) {
    System.out.println("Status: " + response.code());
    System.out.println("Response: " + response.body().string());
} catch (Exception e) {
    e.printStackTrace();
}

JavaScript

XMLHttpRequest

const xhr = new XMLHttpRequest();
xhr.withCredentials = true;
const baseUrl = `https://api.test.kolleges.net/open-api/badge-designs`;
const url = baseUrl + queryParams;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log("Response:", this.responseText);
  }
});

xhr.open("GET", url);
xhr.setRequestHeader("Content-Type", "application/json");
xhr.setRequestHeader("Accept", "application/json");
xhr.setRequestHeader("Authorization", "Bearer " + apiKey);

xhr.send();

HTTP

const https = require("https");
const options = {
  method: "GET",
  hostname: "api.test.kolleges.net",
  path: `/open-api/badge-designs${queryParams}`,
  headers: {
    "Content-Type": "application/json",
    Accept: "application/json",
    Authorization: `Bearer ${apiKey}`,
  },
};

const req = https.request(options, (res) => {
  const chunks = [];

  res.on("data", (chunk) => {
    chunks.push(chunk);
  });

  res.on("end", () => {
    const body = Buffer.concat(chunks).toString();
    console.log("Status:", res.statusCode);
    console.log("Response:", body);
  });
});

req.on("error", (error) => {
  console.error("Error:", error);
});

req.end();

Axios

const axios = require("axios");
const url = `https://api.test.kolleges.net/open-api/badge-designs`;

axios
  .get(url + queryParams, {
    headers: {
      "Content-Type": "application/json",
      Accept: "application/json",
      Authorization: `Bearer ${apiKey}`,
    },
  })
  .then((response) => {
    console.log("Status:", response.status);
    console.log("Response:", response.data);
  })
  .catch((error) => {
    console.error(
      "Error:",
      error.response ? error.response.data : error.message
    );
  });

Fetch

const fetch = require("node-fetch");
const url = `https://api.test.kolleges.net/open-api/badge-designs`;

fetch(url + queryParams, {
  headers: {
    "Content-Type": "application/json",
    Accept: "application/json",
    Authorization: `Bearer ${apiKey}`,
  },
})
  .then((response) => {
    console.log("Status:", response.status);
    return response.json();
  })
  .then((data) => {
    console.log("Response:", data);
  })
  .catch((error) => console.error("Error:", error));

Python

Requests

import requests

url = "https://api.test.kolleges.net/open-api/badge-designs"
headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
    "Authorization": f"Bearer {api_key}"
}

response = requests.get(url + queryParams, headers=headers)

print("Status:", response.status_code)
try:
    print("Response:", response.json())
except Exception as e:
    print("Response:", response.text)

Shell

cURL

curl -X GET "https://api.test.kolleges.net/open-api/badge-designs?page=1&pageSize=10" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $API_KEY"

---