Developers API

nly.kr 단축 URL API로 링크를 자동 생성할 수 있습니다.

01 Endpoint

POST https://nly.kr/api/shorten

Content-Type: application/x-www-form-urlencoded

02 Authentication

API 호출 시 인증을 위해 헤더에 API Key를 포함해야 합니다.

Header(권장): X-API-Key: your_API_KEY
Header(대체): Authorization: Bearer your_API_KEY
Common: Accept: application/json

03 Parameters

Field	Type	Required	Description
url	String	Yes	단축할 원본 URL (http/https만 허용)
category	String	Yes	카테고리 키 (아래 “Allowed Categories” 참고)

Allowed Categories

order: 10

AI/인공지능

AI 도구, 생성형 AI, 자동화 서비스 링크를 모아봅니다.

dev

order: 20

개발/IT

개발 문서, 라이브러리, 레퍼런스, 유용한 개발 링크.

design

order: 30

디자인

아이콘, 폰트, 템플릿, 디자인 리소스 링크.

productivity

order: 40

업무/생산성

협업, 일정, 메모, 문서 정리 등 생산성 도구.

pdf

order: 50

PDF/문서

PDF 변환, 편집, 공유 등 문서 관련 링크.

shopping

order: 60

쇼핑/핫딜

상품, 할인, 비교, 구매 관련 링크.

news

order: 70

뉴스/정보

기사, 블로그, 트렌드 등 정보성 링크.

education

order: 80

교육/강의

강의, 학습 자료, 튜토리얼 링크.

media

order: 90

영상/미디어

유튜브, 스트리밍, 미디어 콘텐츠 링크.

community

order: 100

커뮤니티

포럼, 커뮤니티, Q&A 사이트 링크.

finance

order: 110

금융/투자

금융, 투자, 재테크 관련 링크.

travel

order: 120

여행/맛집

여행 정보, 맛집, 장소 추천 링크.

download

order: 130

자료/다운로드

유틸리티, 자료실, 다운로드 링크.

tools

order: 140

유용한 사이트

카테고리 애매하지만 유용한 링크 모음.

etc

order: 999

기타

분류가 애매한 링크는 여기로 저장됩니다.

WordPressplugins

order: 999

워드프레스 플러그인

워드프레스 플러그인 제작과 관련된 링크를 모아둡니다.

04 Responses

Success (200 OK)

{
  "status": "success",
  "short_url": "https://nly.kr/Ab3XkQ",
  "original_url": "https://example.com",
  "code": "Ab3XkQ",
  "member_idx": 123,
  "category": "ai"
}

Error (4xx, 5xx)

{
  "status": "error",
  "message": "카테고리는 필수입니다."
}

400 : Bad Request

401 : Unauthorized

405 : Method Not Allowed

500 : Server Error

Code Examples v1.0

                  # 1) X-API-Key Header (권장)
curl -X POST "https://nly.kr/api/shorten" \
  -H "X-API-Key: your_API_KEY" \
  -H "Accept: application/json" \
  -d "url=https://example.com" \
  -d "category=ai"

# 2) Authorization Bearer
curl -X POST "https://nly.kr/api/shorten" \
  -H "Authorization: Bearer your_API_KEY" \
  -H "Accept: application/json" \
  -d "url=https://example.com" \
  -d "category=ai"
                

                  <?php
$apiKey  = 'your_API_KEY';
$longUrl = 'https://example.com';
$category = 'ai'; // required

$ch = curl_init('https://nly.kr/api/shorten');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => http_build_query([
        'url'      => $longUrl,
        'category' => $category,
    ]),
    CURLOPT_HTTPHEADER     => [
        'X-API-Key: ' . $apiKey,
        'Accept: application/json',
    ],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 10,
]);

$res  = curl_exec($ch);
$http = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$err  = curl_error($ch);
curl_close($ch);

if ($res === false) die("curl error: {$err}\n");
echo "HTTP: {$http}\n";
print_r(json_decode($res, true));
                

                  const apiKey = "your_API_KEY";
const longUrl = "https://example.com";
const category = "ai"; // required

fetch("https://nly.kr/api/shorten", {
  method: "POST",
  headers: {
    "Content-Type": "application/x-www-form-urlencoded",
    "X-API-Key": apiKey,
    "Accept": "application/json",
  },
  body: new URLSearchParams({ url: longUrl, category }),
})
  .then(async (r) => {
    const data = await r.json().catch(() => null);
    if (!r.ok) throw { status: r.status, data };
    return data;
  })
  .then(console.log)
  .catch((e) => console.error("ERROR", e.status || "", e.data || e));
                

                  import requests

api_key = "your_API_KEY"
long_url = "https://example.com"
category = "ai"  # required

res = requests.post(
    "https://nly.kr/api/shorten",
    headers={"X-API-Key": api_key, "Accept": "application/json"},
    data={"url": long_url, "category": category},
    timeout=10,
)

print("HTTP:", res.status_code)
print(res.json())
                