채널 프로필 API

채널 프로필 정보 조회 및 수정 API입니다.

프로필 조회

Endpoint


GET /v1/channels/{channelId}/profile

Request

Path Parameters

Name	Type	Default
`channelId`	`number` 채널 ID

Response

Name	Type	Default
`channelId`	`number` 채널 ID
`birthday`	`string` 생일 (YYYY-MM-DD)
`residence`	`string` 거주지
`heightCm`	`string` 키 (cm)
`weightKg`	`string` 몸무게 (kg)
`nationality`	`string` 국적 코드 (ISO 3166-1)
`gender`	`"MALE" \| "FEMALE" \| "OTHER"` 성별
`symbolColor`	`string` 심볼 색상 (#RRGGBB)
`agency`	`string` 소속사
`nickname`	`string` 닉네임
`description`	`string` 소개
`affiliatedGroups`	`string[]` 소속 그룹
`fandomName`	`string` 팬덤명
`religion`	`string` 종교
`education`	`Education` 학력 정보
`mbti`	`string` MBTI (예: “INFP”)
`alias`	`string[]` 별명
`debutDate`	`string` 데뷔일 (YYYY-MM-DD)
`broadcastingPlatforms`	`string[]` 방송 플랫폼
`bio`	`string` 짧은 소개
`links`	`Record<string, string>` SNS 링크 (예: youtube, twitter 등)
`homeDescription`	`string` 홈 소개

Examples

cURL

Terminal


curl https://openapi.meloming.com/v1/channels/1/profile

JavaScript

index.js


const response = await fetch('https://openapi.meloming.com/v1/channels/1/profile');
const profile = await response.json();
 
console.log(profile.nickname);
console.log(profile.mbti);

Python

main.py


import requests
 
response = requests.get('https://openapi.meloming.com/v1/channels/1/profile')
profile = response.json()
 
print(profile['nickname'])
print(profile['mbti'])

프로필 수정

인증 필요 - 채널 소유자만 가능

Endpoint


PATCH /v1/channels/{channelId}/profile

Request

Request Body

모든 필드는 선택 사항입니다. 수정하려는 필드만 포함하세요.

Name	Type	Default
`birthday`	`string` 생일 (YYYY-MM-DD)
`residence`	`string` 거주지
`heightCm`	`string` 키
`weightKg`	`string` 몸무게
`nationality`	`string` 국적 코드
`gender`	`"MALE" \| "FEMALE" \| "OTHER"` 성별
`symbolColor`	`string` 심볼 색상 (#RRGGBB)
`agency`	`string` 소속사
`nickname`	`string` 닉네임
`description`	`string` 소개
`affiliatedGroups`	`string[]` 소속 그룹
`fandomName`	`string` 팬덤명
`religion`	`string` 종교
`education`	`EducationUpdate` 학력 정보
`mbti`	`string` MBTI
`alias`	`string[]` 별명
`debutDate`	`string` 데뷔일
`broadcastingPlatforms`	`string[]` 방송 플랫폼
`bio`	`string` 짧은 소개
`links`	`Record<string, string>` SNS 링크
`homeDescription`	`string` 홈 소개

Response

수정된 프로필 정보 (ProfileResponse)가 반환됩니다.

Examples

cURL

Terminal


curl -X PATCH "https://openapi.meloming.com/v1/channels/1/profile" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "nickname": "새 닉네임",
    "bio": "안녕하세요!",
    "mbti": "ENFP"
  }'

JavaScript

index.js


const response = await fetch('https://openapi.meloming.com/v1/channels/1/profile', {
  method: 'PATCH',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    nickname: '새 닉네임',
    bio: '안녕하세요!',
    mbti: 'ENFP'
  })
});
 
const updatedProfile = await response.json();

Python

main.py


import requests
 
response = requests.patch(
    'https://openapi.meloming.com/v1/channels/1/profile',
    headers={'Authorization': 'Bearer YOUR_ACCESS_TOKEN'},
    json={
        'nickname': '새 닉네임',
        'bio': '안녕하세요!',
        'mbti': 'ENFP'
    }
)
updated_profile = response.json()

프로필 이미지 및 배너 이미지 업로드는 별도의 이미지 업로드 API를 통해 처리됩니다.