1. ํ๋์ ๋ณด๊ธฐ
| ํญ๋ชฉ | ๋ด์ฉ |
|---|---|
| ๊ธฐ๋ณธ ์ฃผ์ (๊ตฌ์ถํ) | https://<์ค์น ๋๋ฉ์ธ>/serv/api/external/v1 |
| ๋ฐฉ์ | HTTPS ยท GET ์ ์ฉ ยท JSON(UTF-8) |
| ์ธ์ฆ | API ํค (X-API-Key ํค๋ ๋๋ Authorization: Bearer) |
| ๋ฐ์ดํฐ ๋ฒ์ | ํค๊ฐ ๋ฐ๊ธ๋ ์ํฌ์คํ์ด์ค ํ ๊ณณ์ ๋ฐ์ดํฐ๋ง |
| ์์ฒญ ํ๋ | ํค ํ๋๋น ๊ธฐ๋ณธ ๋ถ๋น 60ํ |
์ฃผ์์ /serv ๊ฐ ๋ค์ด๊ฐ๋๋ค. /serv ์์ด ๋ถ๋ฅด๋ฉด API๊ฐ ์๋๋ผ ์น์ฌ์ดํธ์ 404 ํ์ด์ง๊ฐ ๋์์ต๋๋ค.
์ ๊ณต ์ฐฝ๊ตฌ๋ ๋ค์ ๋ค์ฏ ๊ฐ์ง์ ๋๋ค.
| ๋ฉ์๋ | ๊ฒฝ๋ก | ํ์ํ ๊ถํ ๋ฒ์ | ์ค๋ช |
|---|---|---|---|
| GET | /health | ์์ (ํค ๋ถํ์) | ์๋ฒ ์ํ ํ์ธ |
| GET | /members | members:read | ์ํฌ์คํ์ด์ค ๊ตฌ์ฑ์ ๋ชฉ๋ก (๊ฒ์คํธ ์ ์ธ) |
| GET | /spaces | spaces:read | ๊ณต๊ฐ(๋ถ์ยท๋ฐฉ) ๋ชฉ๋ก |
| GET | /spaces/{id} | spaces:read | ๊ณต๊ฐ 1๊ฑด |
| GET | /attendances | attendances:read | ๊ธฐ๊ฐ๋ณ ๊ทผํ ๊ธฐ๋ก |
2. ์ฒซ ํธ์ถ
โ ์ํ ํ์ธ (ํค ์์ด)
curl -s https://<์ค์น ๋๋ฉ์ธ>/serv/api/external/v1/health{"success":true,"data":{"status":"UP","time":"2026-10-19T14:43:46.414+09:00","build":"unknown"}}โก ๊ตฌ์ฑ์ ์กฐํ (ํค ํ์)
curl -s -H "X-API-Key: $JC_API_KEY" \
"https://<์ค์น ๋๋ฉ์ธ>/serv/api/external/v1/members?limit=50"โข ๊ทผํ ์กฐํ (๊ธฐ๊ฐ ํ์)
curl -s -H "X-API-Key: $JC_API_KEY" \
"https://<์ค์น ๋๋ฉ์ธ>/serv/api/external/v1/attendances?from=2026-10-01&to=2026-10-31"$JC_API_KEY ์๋ ๋ฐ๊ธ๋ฐ์ ํค(jc_ ๋ก ์์)๋ฅผ ๋ฃ์ต๋๋ค. ํค๋ฅผ ์ฝ๋ยท์ ์ฅ์ยท๋ฉ์ ์ ์ ๋จ๊ธฐ์ง ๋ง์ธ์.
3. ์ธ์ฆ
์๋ ๋ ๋ฐฉ์ ์ค ํ๋๋ก ํค๋ฅผ ๋ณด๋
๋๋ค. ๋ ๋ค ๋ณด๋ด๋ฉด X-API-Key ๊ฐ ์ฐ์ ํฉ๋๋ค.
X-API-Key: jc_xxxxxxxxxxxxxxxxAuthorization: Bearer jc_xxxxxxxxxxxxxxxx- ํค๋ ํญ์
jc_๋ก ์์ํฉ๋๋ค.Authorization: Bearer๋ก ๋ณด๋ธ ๊ฐ์ดjc_๋ก ์์ํ์ง ์์ผ๋ฉด ํค๊ฐ ์๋ ๊ฒ์ผ๋ก ๋ณด๊ณ401์ ๋๋ ค์ค๋๋ค. - ํค๋ ๋ฐ๊ธํ ๋ ํ ๋ฒ๋ง ์๋ฌธ์ผ๋ก ๋ณด์ ๋๋ค. ์๋ฒ์๋ ๋๋๋ฆด ์ ์๋ ํํ(ํด์)๋ก๋ง ์ ์ฅ๋๋ฏ๋ก ์์ด๋ฒ๋ฆฌ๋ฉด ๋ค์ ๋ฐ๊ธ๋ฐ์์ผ ํฉ๋๋ค.
- ํค ์์ ยท ๋ชจ๋ฅด๋ ํค ยท ํ๊ธฐ๋ ํค ยท ๋ง๋ฃ๋ ํค ยท ์ฐ๋ ๊ณ์ฝ ์ค์ง๋ ๋ชจ๋ ๊ฐ์
401(JC-4001)์ ๋๋ค. ์ด๋ ๊ฒฝ์ฐ์ธ์ง๋ ์ผ๋ถ๋ฌ ์๋ ค ๋๋ฆฌ์ง ์์ต๋๋ค. /health๋ ํ๋ฆฐ ํค๋ฅผ ๋ถ์ฌ ๋ณด๋ด๋ฉด401์ ๋๋ค. ํค ์์ด ๋ถ๋ฅด๋ฉด 200์ ๋๋ค.- ํค๊ฐ ๊ฐ๋ฆฌํค๋ ์ํฌ์คํ์ด์ค๋ ๋ฐ๊ฟ ์ ์๊ณ , ์์ฒญ์ ์ํฌ์คํ์ด์ค ๋ฒํธ๋ฅผ ๋ฃ๋ ๋งค๊ฐ๋ณ์๋ ์์ต๋๋ค.
4. ๊ถํ ๋ฒ์ (scope)
ํค๋ง๋ค ํ์ฉ๋ ๋ฒ์์ ์ฐฝ๊ตฌ๋ง ๋ถ๋ฅผ ์ ์์ต๋๋ค. ๋ฒ์๊ฐ ์์ผ๋ฉด 403(JC-4003)์ด๋ฉฐ ๋ฉ์์ง์ ํ์ํ ๋ฒ์๊ฐ ์ ํ ์ต๋๋ค.
| scope | ์ด๋ฆฌ๋ ์ฐฝ๊ตฌ |
|---|---|
members:read | GET /members |
spaces:read | GET /spaces ยท GET /spaces/{id} |
attendances:read | GET /attendances |
ํ์ํ ๋ฒ์๋ง ์ ์ฒญํ์ธ์(์ต์ ๊ถํ). ๋ฒ์๋ฅผ ๋ํ๋ ค๋ฉด ํค๋ฅผ ๋ค์ ๋ฐ๊ธ๋ฐ์์ผ ํ ์ ์์ต๋๋ค.
5. ์๋ต ๊ผด
์ฑ๊ณต
{
"success": true,
"data": [ ],
"meta": { "cursor": "bzo1MA", "hasMore": true }
}- ๋ชฉ๋ก ์ฐฝ๊ตฌ(
membersยทspacesยทattendances)๋data๊ฐ ๋ฐฐ์ด์ด๊ณmeta๊ฐ ๋ถ์ต๋๋ค. - ๋จ๊ฑด(
spaces/{id})ยทhealth๋meta๊ฐ ์์ต๋๋ค. - ๊ฐ์ด ์๋ ํ๋๋
null๋ก ์ค์ง ์๊ณ ํค ์์ฒด๊ฐ ๋น ์ง๋๋ค. ยซํค๊ฐ ์์ผ๋ฉด ๊ฐ ์์ยป์ผ๋ก ์ฒ๋ฆฌํ์ธ์. - ์์ผ๋ก ํ๋๊ฐ ๋ํด์ง ์ ์์ต๋๋ค. ๋ชจ๋ฅด๋ ํ๋๋ ๋ฌด์ํ์ธ์.
์คํจ
{
"success": false,
"error": { "code": "JC-4001", "message": "์ ํจํ API ํค๊ฐ ํ์ํฉ๋๋ค." }
}- ํ๋ก๊ทธ๋จ์ด ๋ถ๊ธฐํ ๋๋
error.code๋ฅผ ์ฐ์ธ์.error.message๋ ์ฌ๋์ด ์ฝ๋ ์ค๋ช ์ด๋ผ ๋ฌธ๊ตฌ๊ฐ ๋ค๋ฌ์ด์ง ์ ์์ต๋๋ค. error.detail์ ์์ ๋๋ง ์ต๋๋ค(์ฃผ๋ก ๋งค๊ฐ๋ณ์ ๋๋ฝยทํ์ ์ค๋ฅ). ์คํจ ์๋ต์๋dataยทmeta๊ฐ ์์ต๋๋ค.- ์ฝ๋ ์ ์ฒด ๋ชฉ๋ก์ 10. ์ค๋ฅ ์ฝ๋๋ฅผ ๋ณด์ธ์.
6. ์ชฝ ๋๋๊ธฐ
- ๋ชฉ๋ก์
limit(ํ ๋ฒ์ ๋ฐ์ ๊ฐ์)์cursor(๋ค์ ์ชฝ ํ์ง)๋ก ๋๋ ๋ฐ์ต๋๋ค. limit์ ๊ธฐ๋ณธ 50, ์ต๋ 200์ ๋๋ค. 200๋ณด๋ค ํฌ๋ฉด 200์ผ๋ก, 1๋ณด๋ค ์์ผ๋ฉด 1๋ก ๋ง์ถฐ ์ฒ๋ฆฌํฉ๋๋ค(์ค๋ฅ๊ฐ ์๋๋๋ค). ์ซ์๊ฐ ์๋๋ฉด400์ ๋๋ค.meta.hasMore๊ฐtrue์ด๋ฉดmeta.cursor๋ฅผ ๊ทธ๋๋ก ๋ค์ ์์ฒญ์?cursor=์ ๋ฃ์ต๋๋ค.false์ด๋ฉด ๋ง์ง๋ง ์ชฝ์ด๊ณcursorํค๊ฐ ์์ต๋๋ค.cursor๋ ์์ ์ ์ ์๋ ๋ฌธ์์ด์ ๋๋ค. ํด์ํ๊ฑฐ๋ ์ง์ ๋ง๋ค์ง ๋ง์ธ์. ํ์์ด ํ๋ฆฌ๋ฉด400์ ๋๋ค.- ์ ๋ ฌ์ ๊ณ ์ ์
๋๋ค.
members๋ ๋๋ค์์(๊ฐ์ผ๋ฉดmemberSeq์),spaces๋spaceSeq์,attendances๋attendanceSeq์์ ๋๋ค. ์ชฝ์ ๋๊ธฐ๋ ์ฌ์ด์ ๋ฐ์ดํฐ๊ฐ ๋ฐ๋๋ฉด ์ผ๋ถ๊ฐ ๊ฒน์น๊ฑฐ๋ ๋น ์ง ์ ์์ผ๋, ์ ์ฒด ๋๊ธฐํ๋ ๋๊น์ง ๋ฐ์ ๋ค ๋ฒํธ๋ก ์ค๋ณต์ ์ง์ฐ์ธ์.
URL="https://<์ค์น ๋๋ฉ์ธ>/serv/api/external/v1/members?limit=200"
CURSOR=""
while : ; do
RES=$(curl -s -H "X-API-Key: $JC_API_KEY" "$URL${CURSOR:+&cursor=$CURSOR}")
echo "$RES" | jq -c '.data[]'
[ "$(echo "$RES" | jq -r '.meta.hasMore')" = "true" ] || break
CURSOR=$(echo "$RES" | jq -r '.meta.cursor')
done7. ์์ฒญ ํ๋
- ํ๋๋ API ํค ํ๋๋น ๋ถ๋น ์์ฒญ ์์ ๋๋ค. ๊ธฐ๋ณธ๊ฐ์ 60ํ/๋ถ์ด๊ณ ํค๋ง๋ค ๋ค๋ฅด๊ฒ ์ ํด์ง ์ ์์ต๋๋ค.
- ๋ถ ๋จ์ ๊ณ ์ ๊ตฌ๊ฐ์ผ๋ก ์
๋๋ค(์๊ณ์ ๋ถ์ด ๋ฐ๋๋ฉด 0๋ถํฐ). ์ธ์ฆ์ ํต๊ณผํ ์์ฒญ์ ๊ฒฐ๊ณผ์ ์๊ด์์ด ์
๋๋ค. ์ธ์ฆ ์ ์ ๊ฑฐ์ ๋ ์์ฒญ๊ณผ ํค ์์ด ๋ถ๋ฅธ
health๋ ์ธ์ง ์์ต๋๋ค. - ๋์ผ๋ฉด
429+JC-4029์ ์๋ต ํค๋Retry-After: 60์ด ์ต๋๋ค. ์ด ๊ฐ์ ๋ 60์ด๋ฉฐ ยซ๋จ์ ์ดยป๊ฐ ์๋๋๋ค. - 429๋ฅผ ๋ฐ์ผ๋ฉด
Retry-After๋งํผ ์ฌ๊ณ , ๊ทธ ๋ฐ์ ์ฌ์๋๋ ๊ฐ๊ฒฉ์ ์ง์์ ์ผ๋ก ๋ฒ๋ฆฌ์ธ์.
HTTP/1.1 429
Retry-After: 60
{"success":false,"error":{"code":"JC-4029","message":"๋ถ๋น ์์ฒญ ํ๋(60)๋ฅผ ์ด๊ณผํ์ต๋๋ค."}}8. ์๊ฐ๊ณผ ๋ ์ง
- ์์ฒญ์ ๋ ์ง ๋งค๊ฐ๋ณ์๋
yyyy-MM-dd์ด๋ฉฐ ํ๊ตญ ํ์ค์(KST, UTC+9)์ ๋ ๋ก ํด์ํฉ๋๋ค. - ์๋ต์ ์๊ฐ์ ISO-8601์ด๊ณ ๋
+09:00์ด ๋ถ์ต๋๋ค. ์:2026-10-19T09:01:00+09:00. ๋ฐ๋ฆฌ์ด ์์๋ถ๊ฐ ๋ถ์ ์ ์์ผ๋ ๊ณ ์ ๊ธธ์ด๋ก ์๋ฅด์ง ๋ง๊ณ ISO-8601 ํ์๋ฅผ ์ฐ์ธ์.
9. ์ฐฝ๊ตฌ๋ณ ๋ช ์ธ
/health
ํค ๋ถํ์์๋ฒ ์ํ๋ฅผ ํ์ธํฉ๋๋ค. ํ๋ฆฐ ํค๋ฅผ ๋ถ์ด๋ฉด 401์ ๋๋ค.
| ์๋ต ํ๋ | ํ์ | ์ค๋ช |
|---|---|---|
status | ๋ฌธ์์ด | ์ ์์ด๋ฉด "UP" |
time | ๋ฌธ์์ด(ISO-8601) | ์๋ฒ ํ์ฌ ์๊ฐ(KST) |
build | ๋ฌธ์์ด | ์ง๊ธ ๋๋ ํ์ ์๋ณ๊ฐ. ๋ชจ๋ฅด๋ ํ๊ฒฝ์ด๋ฉด "unknown". ํ์์ ์ฝ์ํ์ง ์์ผ๋ ํ์ยท๊ธฐ๋ก์ฉ์ผ๋ก๋ง ์ฐ์ธ์ |
/members
members:read๊ตฌ์ฑ์ ๋ชฉ๋ก์ ๋๋ค. ๊ฒ์คํธ์ ํํดํ ๊ตฌ์ฑ์์ ๋น ์ง๋๋ค. ๋๋ค์์์ ๋๋ค.
| ๋งค๊ฐ๋ณ์ | ์์น | ํ์ | ์ค๋ช |
|---|---|---|---|
limit | ์ฟผ๋ฆฌ | ์๋์ค | 1~200, ๊ธฐ๋ณธ 50 |
cursor | ์ฟผ๋ฆฌ | ์๋์ค | ์ด์ ์๋ต์ meta.cursor |
| ์๋ต ํ๋ | ํ์ | ์ค๋ช |
|---|---|---|
memberSeq | ์ ์ | ๊ตฌ์ฑ์ ๋ฒํธ(์ํฌ์คํ์ด์ค ์์์ ๊ณ ์ ). ๊ทผํ์ memberSeq ์ ๊ฐ์ ๊ฐ |
account | ๋ฌธ์์ด | ๋ก๊ทธ์ธ ๊ณ์ (์ด๋ฉ์ผ ๊ผด). ์ธ๋ถ ์์คํ ์ ์ง์๊ณผ ๋ง์ถ ๋ ์ฐ๋ ํค |
name | ๋ฌธ์์ด | ์ด๋ฆ |
nickname | ๋ฌธ์์ด | ์ํฌ์คํ์ด์ค์์ ์ฐ๋ ํ์ ์ด๋ฆ |
jobGrade | ๋ฌธ์์ด | ์ง๊ธ (์์ผ๋ฉด ๋น ์ง) |
spaceName | ๋ฌธ์์ด | ์์ ๊ณต๊ฐ(๋ถ์) ์ด๋ฆ (์์ผ๋ฉด ๋น ์ง) |
status | ๋ฌธ์์ด | ํ์ฌ ์ํ ์ด๋ฆ(์: ์จ๋ผ์ธยท์คํ๋ผ์ธยท๋ถ์ฌ์ค). ์ข
๋ฅ๊ฐ ๋ ์ ์์ผ๋ ๋ชจ๋ฅด๋ ๊ฐ๋ ๊ทธ๋๋ก ๋ฐ์ผ์ธ์ |
์ ํ๋ฒํธยท์ฃผ์ยท์์นยท์๋ ์์ผยท์ฌ์ ์ ์ ๋ณด๋ ์ ๊ณตํ์ง ์์ต๋๋ค.
curl -s -H "X-API-Key: $JC_API_KEY" \
"https://<์ค์น ๋๋ฉ์ธ>/serv/api/external/v1/members?limit=2"{
"success": true,
"data": [
{ "memberSeq": 1021, "account": "[email protected]", "name": "ํ๊ธธ๋",
"nickname": "๊ธธ๋", "jobGrade": "๊ณผ์ฅ", "spaceName": "๊ฐ๋ฐํ", "status": "์จ๋ผ์ธ" },
{ "memberSeq": 1034, "account": "[email protected]", "name": "๊น์ฒ ์",
"nickname": "์ฒ ์", "status": "์คํ๋ผ์ธ" }
],
"meta": { "cursor": "bzoy", "hasMore": true }
}/spaces
spaces:read์ฌ์ฉ ์ค์ธ ๊ณต๊ฐ(๋ถ์ยท๋ฐฉ) ๋ชฉ๋ก์
๋๋ค. spaceSeq ์์
๋๋ค. ๋งค๊ฐ๋ณ์๋ limitยทcursor(์์ ๊ฐ์)์
๋๋ค.
| ์๋ต ํ๋ | ํ์ | ์ค๋ช |
|---|---|---|
spaceSeq | ์ ์ | ๊ณต๊ฐ ๋ฒํธ |
name | ๋ฌธ์์ด | ๊ณต๊ฐ ์ด๋ฆ |
topSpaceSeq | ์ ์ | ์์ ๊ณต๊ฐ ๋ฒํธ. ์ต์์ ๊ณต๊ฐ์ด๋ฉด ๋น ์ง |
{
"success": true,
"data": [
{ "spaceSeq": 301, "name": "๋ณธ์ฌ" },
{ "spaceSeq": 305, "name": "๊ฐ๋ฐํ", "topSpaceSeq": 301 }
],
"meta": { "hasMore": false }
}/spaces/{id}
spaces:read๊ณต๊ฐ 1๊ฑด์
๋๋ค. id(๊ฒฝ๋ก, ์ ์)๊ฐ ์ ์๊ฐ ์๋๋ฉด 400 ์
๋๋ค. ์๋ต data ๋ ์ ๋ชฉ๋ก์ ํญ๋ชฉ ํ๋์ ๊ฐ์ต๋๋ค.
curl -s -H "X-API-Key: $JC_API_KEY" "https://<์ค์น ๋๋ฉ์ธ>/serv/api/external/v1/spaces/305"{ "success": true, "data": { "spaceSeq": 305, "name": "๊ฐ๋ฐํ", "topSpaceSeq": 301 } }์๋ ๊ณต๊ฐ, ์ง์์ง ๊ณต๊ฐ, ๋ค๋ฅธ ์ํฌ์คํ์ด์ค์ ๊ณต๊ฐ์ ๋ชจ๋ ๊ฐ์ 404(JC-4004)์
๋๋ค. ๋จ์ ๋ฐ์ดํฐ๊ฐ ์๋์ง ์ ์ ์๊ฒ ํ๋ ค๋ ๊ฒ์
๋๋ค.
/attendances
attendances:read๊ธฐ๊ฐ ์์ ์ถ๊ทผ ๊ธฐ๋ก์ด ์๋ ๊ทผํ๋ฅผ ๋๋ ค์ค๋๋ค.
| ๋งค๊ฐ๋ณ์ | ์์น | ํ์ | ์ค๋ช |
|---|---|---|---|
from | ์ฟผ๋ฆฌ | ์ | ์์์ผ yyyy-MM-dd (KST, ๊ทธ๋ 00:00๋ถํฐ) |
to | ์ฟผ๋ฆฌ | ์ | ์ข
๋ฃ์ผ yyyy-MM-dd (KST, ๊ทธ๋ ๋๊น์ง ํฌํจ) |
memberSeq | ์ฟผ๋ฆฌ | ์๋์ค | ์ด ๊ตฌ์ฑ์์ ๊ทผํ๋ง. ์๋ ๋ฒํธ๋ฉด ๋น ๋ชฉ๋ก |
limit | ์ฟผ๋ฆฌ | ์๋์ค | 1~200, ๊ธฐ๋ณธ 50 |
cursor | ์ฟผ๋ฆฌ | ์๋์ค | ์ด์ ์๋ต์ meta.cursor |
fromยทto๋ ๋ ๋ค ํ์์ ๋๋ค. ๋น ์ง๊ฑฐ๋ ํ์์ด ํ๋ฆฌ๊ฑฐ๋to๊ฐfrom๋ณด๋ค ์์๋ฉด400์ ๋๋ค.- ์กฐํ ๊ธฐ๊ฐ์ ์ต๋ 92์ผ์ ๋๋ค(์ ๋ ๋ ํฌํจ, ์: 2026-07-01 ~ 2026-09-30). ๋ ๊ธด ๊ธฐ๊ฐ์ ๋๋ ๋ฐ์ผ์ธ์.
- ๊ธฐ๊ฐ์ ์ฒ์ ์ฐํ ์ถ๊ทผ ์๊ฐ ๊ธฐ์ค์ผ๋ก ๊ฑฐ๋ฆ
๋๋ค. ๊ด๋ฆฌ์๊ฐ ์ถ๊ทผ ์๊ฐ์ ๊ณ ์น ๊ธฐ๋ก๋ ์ฒ์ ์ฐํ ๋ ์ด ๊ธฐ๊ฐ ์์ด๋ฉด ๋์ค๋ฉฐ, ์ด๋
clockIn์๋ ๊ณ ์น ๊ฐ์ด ์ต๋๋ค.
| ์๋ต ํ๋ | ํ์ | ์ค๋ช |
|---|---|---|
attendanceSeq | ์ ์ | ๊ทผํ ๊ธฐ๋ก ๋ฒํธ |
memberSeq | ์ ์ | ๊ทผ๋ฌด์ ๊ตฌ์ฑ์ ๋ฒํธ |
memberName | ๋ฌธ์์ด | ๊ทผ๋ฌด์ ๋๋ค์ |
clockIn | ๋ฌธ์์ด(ISO-8601) | ์ถ๊ทผ ์๊ฐ. ๊ด๋ฆฌ์๊ฐ ๊ณ ์น ๊ฐ์ด ์์ผ๋ฉด ๊ทธ ๊ฐ |
clockOut | ๋ฌธ์์ด(ISO-8601) | ํด๊ทผ ์๊ฐ. ์์ง ํด๊ทผํ์ง ์์์ผ๋ฉด ๋น ์ง |
outside | ๋ฌธ์์ด(HH:mm) | ๊ทธ๋ ยซ์ธ๊ทผ์คยป์ด์๋ ์๊ฐ. ์์ผ๋ฉด "00:00" |
missed | ๋ฌธ์์ด(HH:mm) | ๊ทธ๋ ยซ๋ถ์ฌ์คยป์ด์๋ ์๊ฐ. ์์ผ๋ฉด "00:00" |
๊ทผํ์ ๋น๊ณ (๋ฉ๋ชจ)๋ ๊ฐ์ธ์ ๋ณด๊ฐ ์์ผ ์ ์์ด ์ ๊ณตํ์ง ์์ต๋๋ค. ์ค๋ ๊ธฐ๋ก์ outsideยทmissed ๋ ์ง๊ธ๊น์ง๋ก ์ธ๋ฏ๋ก ๋ค์ ๋ฐ์ผ๋ฉด ๋์ด๋ ์ ์์ต๋๋ค.
curl -s -H "X-API-Key: $JC_API_KEY" \
"https://<์ค์น ๋๋ฉ์ธ>/serv/api/external/v1/attendances?from=2026-10-19&to=2026-10-19&memberSeq=1021"{
"success": true,
"data": [
{ "attendanceSeq": 88123, "memberSeq": 1021, "memberName": "๊ธธ๋",
"clockIn": "2026-10-19T08:57:12+09:00", "clockOut": "2026-10-19T18:03:40+09:00",
"outside": "01:20", "missed": "00:00" }
],
"meta": { "hasMore": false }
}{ "success": false, "error": { "code": "JC-4000", "message": "์กฐํ ๊ธฐ๊ฐ์ ์ต๋ 92์ผ๊น์ง ๊ฐ๋ฅํฉ๋๋ค." } }
{ "success": false, "error": { "code": "JC-4000",
"message": "์์ฒญ ํ๋ผ๋ฏธํฐ๊ฐ ์ฌ๋ฐ๋ฅด์ง ์์ต๋๋ค.", "detail": "'from' ์นธ์ด ํ์ํฉ๋๋ค." } }10. ์ค๋ฅ ์ฝ๋
| ์ฝ๋ | HTTP | ๋ป | ๋ํ ์ํฉ | ๋ค์ ํ๋ฉด? |
|---|---|---|---|---|
JC-4000 | 400 | ์๋ชป๋ ์์ฒญ | ๊ทผํ from/to ๋๋ฝยทํ์ ์ค๋ฅยท92์ผ ์ด๊ณผ, cursor ํด์ ๋ถ๊ฐ, ์ซ์ ์๋ฆฌ์ ์ซ์๊ฐ ์๋ | ์์ฒญ์ ๊ณ ์ณ์ผ ํจ |
JC-4001 | 401 | ์ธ์ฆ ์คํจ | ํค ์์ยท๋ชจ๋ฅด๋ ํคยทํ๊ธฐยท๋ง๋ฃยท์ฐ๋ ์ค์ง, health ์ ํ๋ฆฐ ํค | ํค ํ์ธ ๋๋ ์ฌ๋ฐ๊ธ |
JC-4003 | 403 | ๊ถํ ๋ฒ์ ๋ถ์กฑ | ํค์ ๊ทธ ์ฐฝ๊ตฌ์ scope ๊ฐ ์์(๋ฉ์์ง์ ํ์ํ scope: โฆ) | ๋ฒ์ ์ถ๊ฐ ์ ์ฒญ |
JC-4004 | 404 | ์ฐพ์ ์ ์์ | ์๋ยท์ง์์ง ๊ณต๊ฐ, ๋๋ ๋ค๋ฅธ ์ํฌ์คํ์ด์ค์ ๊ณต๊ฐ | ๋ฒํธ ํ์ธ |
JC-4029 | 429 | ์์ฒญ ํ๋ ์ด๊ณผ | ํค ํ๋์ ๋ถ๋น ํ๋ ์ด๊ณผ ยท Retry-After: 60 | 60์ด ๋ค |
JC-5000 | 500 | ์๋ฒ ๋ด๋ถ ์ค๋ฅ | ์๊ธฐ์น ๋ชปํ ์ค๋ฅ(์๋ต์๋ ์ผ๋ฐ ๋ฌธ๊ตฌ๋ง) | ์ ์ ๋ค ์ฌ์๋, ๊ณ์๋๋ฉด ๋ฌธ์ |
- 401์ ์์ธ์ ๋๋์ง ์๊ณ , 403์ scope ๋ถ์กฑ ํ ๊ฐ์ง์ ๋๋ค. ๋จ์ ์ํฌ์คํ์ด์ค ๋ฐ์ดํฐ๋ 403์ด ์๋๋ผ 404์ ๋๋ค.
- 4xxx ๋ ์์ฒญํ๋ ์ชฝ, 5xxx ๋ ์๋ฒ ์ชฝ ์ฑ ์์ ๋๋ค. ํ์ ์๋ ์ฝ๋๋ฅผ ๋ฐ์ผ๋ฉด HTTP ์ํ๋ฅผ ๊ธฐ์ค์ผ๋ก ์ฒ๋ฆฌํ๊ณ ์๋ ค ์ฃผ์ธ์.
- ์๋ฒ ์๋จ(๋ฐฉํ๋ฒฝยทCDN)์ด ๊ฑฐ์ ํ ๊ฒฝ์ฐ(502ยท503ยท504 ๋ฑ)์ ์ ์๋์ง ์์ ๊ฒฝ๋ก๋ ์ ๊ผด์ด ์๋ ์ ์์ต๋๋ค. ๋ณธ๋ฌธ์ด JSON์ด ์๋๋ฉด ์ฃผ์๋ถํฐ ํ์ธํ์ธ์.
11. ์นํ ๋ฐ๊ธฐ (์๋ฆผ ๋ด๋ณด๋ด๊ธฐ)
ํ์ฌ์ด๋๊ฐ ์ ๋ฌด ์๋ฆผ์ ๊ณ ๊ฐ์ด ์ ํ ์ฃผ์๋ก ๋ณด๋ด๋ ๊ธฐ๋ฅ์ ๋๋ค. ์์ ์ฝ๊ธฐ API์ ๋ฌ๋ฆฌ ยซ๋ฐ๋ ์ชฝยป์ ๊ฐ๋ฐํ ๋์ ์ค๋ช ์ ๋๋ค.
์ค์ ๊ณผ ์ ์
- ์ํฌ์คํ์ด์ค์ ์์ ์ยท๊ด๋ฆฌ์๊ฐ ์ค์ ํ๋ฉด์์ ๋ฐ๋ ์ฃผ์๋ฅผ ๋ฑ๋กํฉ๋๋ค(์ํฌ์คํ์ด์ค๋น ์ต๋ 20๊ณณ). API ํค๋ก๋ ๋ฑ๋กํ์ง ๋ชปํฉ๋๋ค.
- ๋ฐ๋ ๊ณณ๋ง๋ค ๋ฐ์ ์๋ฆผ ์ข ๋ฅ(๋๋ ยซ์ ๋ถยป)ยท๋ฒ์(์ํฌ์คํ์ด์ค ์ ์ฒด / ํน์ ํ๋ก์ ํธ / ํน์ ๊ฒฐ์ฌ ์์)ยท์ ๋ชฉ ์จ๊ธฐ๊ธฐ๋ฅผ ๊ณ ๋ฆ ๋๋ค. ์ ๋ชฉ ์จ๊ธฐ๊ธฐ๋ฅผ ์ผ๋ฉด ๋ณธ๋ฌธ์์ ์ ๋ชฉ์ด ์์ ๋น ์ง๋๋ค.
- ์ฃผ์๋ ์ธํฐ๋ท์์ ๋ฟ์์ผ ํฉ๋๋ค. ์ฌ๋ด ์ฌ์ค๋ง ์ฃผ์๋ ๋ฑ๋กํ ์ ์๊ณ , ๋ณด๋ด๊ธฐ ์ง์ ์๋ ๋ค์ ๊ฒ์ฌํฉ๋๋ค. ๋ฆฌ๋ค์ด๋ ํธ(3xx)๋ ๋ฐ๋ผ๊ฐ์ง ์์ผ๋ ์ต์ข ์ฃผ์๋ฅผ ๋ฑ๋กํ์ธ์.
- ๋ณด๋ด๊ธฐ ๊ธฐ๋ฅ์ ์๋ฒ ์ด์์๊ฐ ์ผ์ผ ๋์ํฉ๋๋ค. ๋์ ํ ๋ ์ผ์ ธ ์๋์ง ํ์ธํ์ธ์.
๋ณด๋ด๋ ๋ฐฉ์
POSTยทContent-Type: application/jsonยท UTF-8 JSON ๋ณธ๋ฌธ.- ์ฐ๊ฒฐ 3์ดยท์๋ต 10์ด ์์
2xx๋ก ๋ตํด์ผ ๋ฐ์ ๊ฒ์ผ๋ก ์นฉ๋๋ค. ์ค๋ ๊ฑธ๋ฆฌ๋ ์ฒ๋ฆฌ๋ ๋ฐ์ ๋ค ๋ฐ๋ก ํ์ธ์. - ์๋ช
ํค๋ฅผ ๋ฑ๋กํ ๊ณณ์๋ ํค๋
X-JC-Signature: sha256=<์๋ฌธ์ hex>๊ฐ ๋ถ์ต๋๋ค. - ๊ฐ์ ๊ณณ์ ๋ณด๋ธ ์๊ฐ์ด ๋ ํค๋
X-JC-Signature-V2: t=<์ ๋์ค ์ด>,v1=<์๋ฌธ์ hex>๋ ํจ๊ป ๋ถ์ต๋๋ค(2026-11-08~). ๊ฐ๋ก์ฑ ์์ฒญ์ ๋์ค์ ๋ค์ ๋ณด๋ด๋ ๊ฒ์ ๋ง์ผ๋ ค๋ฉด ์ด์ชฝ์ ํ์ธํ์ธ์. - ์ฌ์๋ ๋๋ฌธ์ ๊ฐ์ ๋ณธ๋ฌธ์ด ๋ ๋ฒ ์ด์ ์ฌ ์ ์์ต๋๋ค.
eventยทalarmSeq(์์ผ๋ฉดoccurredAt+subject)๋ก ์ค๋ณต์ ๊ฑฐ๋ฅด์ธ์.
์๋ช ๊ฒ์ฆ
์๋ช ์ ๋ฐ์ ๋ณธ๋ฌธ ๋ฐ์ดํธ ๊ทธ๋๋ก(๋ค์ ์ง๋ ฌํํ์ง ์์ ์๋ฌธ)์ ๋ํ HMAC-SHA256์ด๊ณ , ์ด์ ๋ ๋ฑ๋กํ ์๋ช ํค์ ๋๋ค. ๋น๊ต๋ ์๊ฐ์ฐจ๊ฐ ๋๋ฌ๋์ง ์๋ ๋ฐฉ์์ผ๋ก ํ์ธ์.
const crypto = require('crypto');
function verify(rawBody, header, secret) {
const expected = 'sha256=' + crypto.createHmac('sha256', secret).update(rawBody, 'utf8').digest('hex');
const a = Buffer.from(expected), b = Buffer.from(header || '');
return a.length === b.length && crypto.timingSafeEqual(a, b);
}import hmac, hashlib
def verify(raw_body: bytes, header: str, secret: str) -> bool:
expected = 'sha256=' + hmac.new(secret.encode(), raw_body, hashlib.sha256).hexdigest()
return hmac.compare_digest(expected, header or '')๋ณด๋ธ ์๊ฐ์ด ๋ ์๋ช (V2) ๊ฒ์ฆ
v1 ์ t + . + ๋ฐ์ ๋ณธ๋ฌธ ๋ฐ์ดํธ ๊ทธ๋๋ก์ ๋ํ HMAC-SHA256์
๋๋ค. t ๊ฐ ์ง๊ธ๊ณผ 5๋ถ ๋๊ฒ ์ฐจ์ด ๋๋ฉด ๋ฒ๋ฆฌ์ธ์. ์ฌ์๋ ๋๋ ๊ทธ๋ ์๊ฐ์ผ๋ก ๋ค์ ์๋ช
ํด ๋ณด๋
๋๋ค. ์ X-JC-Signature ๋ ๊ณ์ ๋ถ์ผ๋ ์ด๋ฏธ ๋ง๋ ๊ฒ์ฆ์ ๊ทธ๋๋ก ๋ฌ๋ ๋ฉ๋๋ค.
const crypto = require('crypto');
// header ์: "t=1700000000,v1=2f65โฆ" ยท 5๋ถ(300์ด)๋ณด๋ค ์ค๋๋ ๊ฒ์ ๋ฒ๋ฆฐ๋ค
function verifyV2(rawBody, header, secret, nowSec = Math.floor(Date.now() / 1000)) {
const m = /^t=(\d+),v1=([0-9a-f]{64})$/.exec(header || '');
if (!m || Math.abs(nowSec - Number(m[1])) > 300) return false;
const expected = crypto.createHmac('sha256', secret).update(m[1] + '.' + rawBody, 'utf8').digest('hex');
return crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(m[2]));
}๋ณธ๋ฌธ (์ผ๋ฐ JSON ์ฃผ์)
{
"event": "approval.requested",
"occurredAt": 1792382400000,
"workspaceSeq": 12,
"alarmSeq": 55012,
"actor": "๊ธธ๋",
"recipients": [1034, 1050],
"subject": { "requestSeq": 7001, "title": "10์ ์ถ์ฅ๋น", "requestType": "๊ฒฝ๋น์ ์ฒญ์" }
}| ํ๋ | ์ค๋ช |
|---|---|
event | ์ฌ๊ฑด ํค(์๋ ํ). ํ ๋ฒ ์ ํ ์ด๋ฆ์ ๋ฐ๊พธ์ง ์์ต๋๋ค |
occurredAt | ์ฌ๊ฑด ์๊ฐ. epoch ๋ฐ๋ฆฌ์ด(์ซ์) |
workspaceSeq | ์ํฌ์คํ์ด์ค ๋ฒํธ |
alarmSeq | ์๋ฆผ ๋ฒํธ(์๋ฆผ ํ์ด ์๋ ์ฌ๊ฑด์ ๋น ์ง) |
actor | ์ฌ๊ฑด์ ์ผ์ผํจ ์ฌ๋์ ํ์ ์ด๋ฆ |
recipients | ์๋ฆผ์ ๋ฐ๋ ๊ตฌ์ฑ์ ๋ฒํธ ๋ชฉ๋ก(์๋ฆผ ํ์ด ์๋ ์ฌ๊ฑด์ ๋น ์ง) |
subject | ์ฌ๊ฑด ๋ด์ฉ. ์ข ๋ฅ๋ง๋ค ํ๋๊ฐ ๋ค๋ฅด๊ณ ๋์ด๋ ์ ์์ต๋๋ค. ์ ๋ชฉ ์จ๊ธฐ๊ธฐ๋ฅผ ์ผ ๊ณณ์๋ ํค ์์ฒด๊ฐ ์์ต๋๋ค |
์ฌ๋์ด ์ฝ๋ ๋ฌธ์ฅ์ ์ผ๋ฐ JSON์ ๋ด๊ธฐ์ง ์์ต๋๋ค. ์ฌ๊ฑด ํค๋ก ์ง์ ๋ฌธ๊ตฌ๋ฅผ ๋ง๋์ธ์.
์ฌ๊ฑด ํค
| ๋ฌถ์ | ์ฌ๊ฑด ํค |
|---|---|
| ๊ฒฐ์ฌ | approval.requestedapproval.forwardedapproval.referencedapproval.approvedapproval.rejectedapproval.withdrawnapproval.canceledapproval.deletedapproval.commentedapproval.dueapproval.reminded |
| ๊ทผํยท์ฐ์ฐจ | attendance.week.warnattendance.week.overvacation.promotion.urgedvacation.promotion.assigned |
| ๋ฌธ์ยท๊ฒ์ยท์ค๋ฌธ | inquiry.createdboard.postedsurvey.openedsurvey.reopened |
| ํ์ยท์ธ๋ฏธ๋ยท์์ | meeting.scheduledmeeting.canceledmeeting.startedseminar.scheduledseminar.canceledseminar.startedresource.bookedresource.canceled |
| ์นธ๋ฐ | task.assignedtask.duetask.completed (ํ๋ก์ ํธ๋ฅผ ๊ณ ๋ฅธ ๋ฐ๋ ๊ณณ์๋ง) |
| ๊ตฌ์ฑ์ | member.joined (ยซ์ ๋ถยป๋ฅผ ๊ณ ๋ฅธ ์ผ๋ฐ JSON ์ฃผ์์๋ง) |
member.joined ๋ ยซ์ ๋ถยป๋ฅผ ๊ณ ๋ฅธ ์ผ๋ฐ JSON ์ฃผ์์๋ง ๊ฐ๋ฉฐ, ์ด ์ฌ๊ฑด์ occurredAt ์ ์ซ์๊ฐ ์๋๋ผ ๋ฌธ์์ด์
๋๋ค. event ๋ก ๋จผ์ ๋ถ๊ธฐํ์ธ์.
TeamsยทSlack ์ผ๋ก ๋ฐ๊ธฐ
์ฃผ์์ ํธ์คํธ๊ฐ hooks.slack.com, *.webhook.office.com, *.environment.api.powerplatform.com, *.logic.azure.com ์ด๋ฉด ๊ทธ ์๋น์ค๊ฐ ๊ทธ๋ฆฌ๋ ๊ผด๋ก ํ ์ค ์๋ฆผ์ ๋ง๋ค์ด ๋ณด๋
๋๋ค. ์ด๋๋ ์์ ์ผ๋ฐ JSONยท์๋ช
์ ์ฐ์ง ์์ต๋๋ค.
์คํจ์ ์ฌ์๋
| ๋ฐ์ ์๋ต | ์ฒ๋ฆฌ |
|---|---|
2xx | ์ฑ๊ณต |
408 ยท 429 ยท 5xx ยท 3xx ยท ์ฐ๊ฒฐ ์คํจยท์๊ฐ ์ด๊ณผ | ๋ค์ ์๋ |
๊ทธ ๋ฐ์ 4xx | ๋ฐ๋ก ํฌ๊ธฐ |
์ต์ด 1ํ์ ์ฌ์๋ 4ํ, ๋ชจ๋ 5ํ๊น์ง ์๋ํ๋ฉฐ ๊ฐ๊ฒฉ์ ์ ์ ๋ฒ์ด์ง๋๋ค(์ต๋ 4๋ถ ์ํ). 5ํ ๋ชจ๋ ์คํจํ ๊ฑด์ ๋ค์ ๋ณด๋ด์ง ์์ต๋๋ค. ๋ฐ๋ ๊ณณ์ ๋ ๋์์ ์๋ฆผ์ ์์ด์ง ์์ต๋๋ค.
12. AI ๋๊ตฌ ์ฐ๊ฒฐ (MCP)
ClaudeยทChatGPTยทGemini ๊ฐ์ AI ๋๊ตฌ๊ฐ ๊ฐ์ API ํค๋ก ํ์ฌ์ด๋๋ฅผ MCP ๋๊ตฌ๋ก ์ธ ์ ์์ต๋๋ค. ๋ณ๋ ์๋ฒ ์์ด ์ฃผ์ ํ๋์ ๋ถ์ต๋๋ค.
| ํญ๋ชฉ | ๊ฐ |
|---|---|
| ์ฃผ์ | https://<์ค์น ๋๋ฉ์ธ>/serv/api/external/v1/mcp |
| ๋ฐฉ์ | MCP Streamable HTTP ยท ์ํ ์์ |
| ์ธ์ฆ | 3์ฅ๊ณผ ๊ฐ์ API ํค (Authorization: Bearer jc_โฆ ๋๋ X-API-Key) |
ํค์ ๊ถํ ๋ฒ์์ ๋ ์ฝ๊ธฐ ๋๊ตฌ๋ง ๋ณด์
๋๋ค: list_members ยท list_spaces ยท get_space ยท list_attendances. ๊ท์น(์ปค์ยทlimitยท92์ผ)์ REST ์ฐฝ๊ตฌ์ ๊ฐ๊ณ , MCP ์์ฒญ ํ ํต๋ง๋ค ์์ฒญ ํ๋์์ 1ํ๋ฅผ ์
๋๋ค.
claude mcp add --transport http joycollab https://<์ค์น ๋๋ฉ์ธ>/serv/api/external/v1/mcp \
--header "Authorization: Bearer ${JC_API_KEY}"AI ๋๊ตฌ๋ก ์ฝ์ ๊ตฌ์ฑ์ยท๊ทผํ ์ ๋ณด๋ ๊ณ ๊ฐ์ด ๊ณ ๋ฅธ AI ์ ์ฒด๋ก ๋์ด๊ฐ๋๋ค. ์ฐ๊ธฐ ์ ์ ์ฌ๋ด ๊ฐ์ธ์ ๋ณด ์ฒ๋ฆฌ ๊ธฐ์ค(๊ตฌ์ฑ์ ๋์ยท์ํ ๊ณ์ฝ ๋ฑ)์ ํ์ธํ์ธ์.
๋๊ตฌ๋ณ ์ฐ๊ฒฐ ์์๋ ๋์ ์๋ด ๋ ํจ๊ป ๋๋ฆฝ๋๋ค. MCP ์ฐ๊ฒฐ์ ์ฒ์์ ๊บผ์ ธ ์๊ณ , ํ์ฌ๊ฐ ์ผค์ง ์ ํฉ๋๋ค.
13. ํค ๋ฐ๊ธ๊ณผ ๊ด๋ฆฌ
์ํฌ์คํ์ด์ค ์์ ์ยท๊ด๋ฆฌ์๋ ํ์ฌ์ด๋ ์ค์ โบ ๊ด๋ฆฌ์ ์ค์ โบ ยซ์ธ๋ถ ์ฐ๋ ํคยป์์ ํค๋ฅผ ์ง์ ๋ง๋ค๊ณ ๋์ ์ ์์ต๋๋ค. ํค๋ง๋ค ์ฝ์ ํญ๋ชฉ(4์ฅ)์ ๊ณ ๋ฅด๊ณ , ์๋ฌธ์ ๋ง๋ค ๋ ํ ๋ฒ๋ง ๋ณด์ ๋๋ค. ์ฌ์ฉ ์ค์ธ ํค๋ ์ํฌ์คํ์ด์ค๋น 10๊ฐ๊น์ง์ ๋๋ค.
์ง์ ๋ง๋ค๊ธฐ ์ด๋ ต๊ฑฐ๋ ํ๋ ์กฐ์ ์ด ํ์ํ๋ฉด ์๋๋ฅผ ์ ์ด ์ ์ฒญํด ์ฃผ์ธ์.
- ์ฐ๋ํ ์ํฌ์คํ์ด์ค(์ด๋ฆ ๋๋ ์ฃผ์)
- ํ์ํ ๊ถํ ๋ฒ์(4์ฅ)
- ์์ ํธ์ถ๋(๋ถ๋น ๋ช ํ, ๋๊ธฐํ ์ฃผ๊ธฐ)
- ํค ๋ง๋ฃ์ผ ํฌ๋ง ์ฌ๋ถ
- AI ๋๊ตฌ(MCP)๋ก ์ธ์ง ์ฌ๋ถ โ ์ด๋ค๋ฉด ์ฌ๋ด ๊ฐ์ธ์ ๋ณด ์ฒ๋ฆฌ ๊ธฐ์ค์ ํ์ธํ๋ค๋ ํ์ธ
ํค๋ฅผ ์์ด๋ฒ๋ ธ๊ฑฐ๋ ์์ด ๋๊ฐ ๊ฒ ๊ฐ์ผ๋ฉด ๋ฐ๋ก ์๋ ค ์ฃผ์ธ์. ํ๊ธฐํ๊ณ ๋ค์ ๋ฐ๊ธํด ๋๋ฆฝ๋๋ค. ๊ตฌ์ถํ์ ์ค์น ๋ด๋น์์๊ฒ ์์ฒญํฉ๋๋ค.
์ฐ๋ ๋ฒ์ยทํธ์ถ๋ ์๋ด์ด ํ์ํ์๋ฉด ํธํ๊ฒ ๋ฌธ์ํด ์ฃผ์ธ์.
API ํค ยท ์ฐ๋ ๋ฌธ์14. ๋ฌธ์ ํด๊ฒฐ
| ์ฆ์ | ํ์ธํ ๊ฒ |
|---|---|
| ์น์ฌ์ดํธ 404 HTML์ด ์ด | ์ฃผ์์ /serv ๊ฐ ๋น ์ก๋์ง |
401 | ํค ์คํยทjc_ ์ ๋๋ถยทBearer ๋ค ๊ณต๋ฐฑยท๋ง๋ฃยทํ๊ธฐ. health ์ ํ๋ฆฐ ํค๋ฅผ ๋ถ์ด์ง ์์๋์ง |
403 | ๋ฉ์์ง์ ํ์ํ scope ๋ฅผ ์ ์ฒญ |
400 + ๊ทผํ | fromยทto ํ์, 92์ผ ์ด๋ด, to โฅ from |
404 + ๊ณต๊ฐ | ๊ณต๊ฐ ๋ฒํธ๊ฐ ์ด ํค์ ์ํฌ์คํ์ด์ค ๊ฒ์ธ์ง |
429 | ๋ถ๋น ํ๋ ์ด๊ณผ. 60์ด ๋ค ๋ค์ |
| ๋ด์ฉ์ด ๊ฒน์น๊ฑฐ๋ ๋น ์ง | ์ชฝ์ ๋๊ธฐ๋ ์ฌ์ด ๋ฐ์ดํฐ๊ฐ ๋ฐ๋. 6์ฅ ์ฐธ๊ณ |
์ต์ข ๊ฐฑ์ 2026-11-06 ยท API v1