SHORT API 문서

⚡ 빠른 시작

단 한 줄의 코드로 짧은 URL을 만들어보세요!

curl -X POST https://short.kdnoito.me/api/create \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

📌 기본 정보

Base URL: https://short.kdnoito.me

인증: HTTP Header X-API-KEY 필수

응답 형식: JSON

CORS: 모든 도메인 허용 (*)

📡 API 엔드포인트

POST /api/create

새로운 짧은 URL을 생성합니다.

Headers

Header	값	설명
`X-API-KEY`	string	서버에 설정된 API Key

Request Body

파라미터	타입	필수	설명
`url`	string	필수	단축할 원본 URL
`custom_code`	string	선택	커스텀 짧은 코드

예제

curl -X POST https://short.kdnoito.me/api/create \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: YOUR_API_KEY" \
  -d '{"url": "https://example.com", "custom_code": "mylink"}'

JavaScript

const response = await fetch('https://short.kdnoito.me/api/create', {
  method: 'POST',
  headers: { 
    'Content-Type': 'application/json',
    'X-API-KEY': 'YOUR_API_KEY'
  },
  body: JSON.stringify({ url: 'https://example.com' })
});
const data = await response.json();

Response

{
  "success": true,
  "short_code": "mylink",
  "short_url": "https://short.kdnoito.me/mylink",
  "long_url": "https://example.com",
  "created_at": "2026-01-05 12:34:56"
}

GET /api/list

모든 짧은 URL 목록을 조회합니다.

Query Parameters

파라미터	타입	기본값	설명
`page`	integer	1	페이지 번호
`limit`	integer	50	페이지당 항목 수

curl https://short.kdnoito.me/api/list?page=1&limit=10

Response

{
  "success": true,
  "data": [
    {
      "short_code": "mylink",
      "short_url": "https://short.kdnoito.me/mylink",
      "long_url": "https://example.com",
      "clicks": 42,
      "created_at": "2026-01-05 12:34:56",
      "last_accessed": "2026-01-05 14:20:30"
    }
  ],
  "pagination": { "page": 1, "limit": 10, "total": 1, "pages": 1 }
}

GET /api/stats/{code}

특정 짧은 URL의 통계를 조회합니다.

curl https://short.kdnoito.me/api/stats/mylink

Response

{
  "success": true,
  "data": {
    "short_code": "mylink",
    "short_url": "https://short.kdnoito.me/mylink",
    "long_url": "https://example.com",
    "clicks": 42,
    "created_at": "2026-01-05 12:34:56",
    "last_accessed": "2026-01-05 14:20:30"
  }
}

DELETE /api/delete/{code}

짧은 URL을 삭제합니다.

curl -X DELETE https://short.kdnoito.me/api/delete/mylink

Response

{
  "success": true,
  "message": "삭제되었습니다",
  "short_code": "mylink"
}

💡 사용 예제

HTML에서 사용하기

<script>
async function shortenUrl(url) {
    const res = await fetch('https://short.kdnoito.me/api/create', {
        method: 'POST',
        headers: { 
            'Content-Type': 'application/json',
            'X-API-KEY': 'YOUR_API_KEY'
        },
        body: JSON.stringify({ url })
    });
    const data = await res.json();
    console.log(data.short_url);
}
</script>

Python에서 사용하기

import requests

response = requests.post(
    'https://short.kdnoito.me/api/create',
    headers={'X-API-KEY': 'YOUR_API_KEY'},
    json={'url': 'https://example.com'}
)
print(response.json()['short_url'])

PHP에서 사용하기

$data = json_encode(['url' => 'https://example.com']);
$opts = [
    'http' => [
        'method' => 'POST',
        'header' => [
            'Content-Type: application/json',
            'X-API-KEY: YOUR_API_KEY'
        ],
        'content' => $data
    ]
];
$result = file_get_contents(
    'https://short.kdnoito.me/api/create',
    false,
    stream_context_create($opts)
);
$response = json_decode($result);
echo $response->short_url;

❓ FAQ

Q: API 사용에 제한이 있나요?
A: 현재는 사용 제한이 없습니다.

Q: 커스텀 코드를 사용할 수 있나요?
A: 네, custom_code 파라미터를 사용하세요. 영문자, 숫자, -, _ 만 가능합니다.

Q: HTTPS를 지원하나요?
A: 현재는 HTTP만 지원합니다.

🔗 SHORT API 문서

⚡ 빠른 시작

📌 기본 정보

📡 API 엔드포인트

POST /api/create

Headers

Request Body

예제

JavaScript

Response

GET /api/list

Query Parameters

Response

GET /api/stats/{code}

Response

DELETE /api/delete/{code}

Response

💡 사용 예제

HTML에서 사용하기

Python에서 사용하기

PHP에서 사용하기

❓ FAQ