제이비소프트 URLLY

API 엔드포인트

POST https://urlly.kr/api/create.php

요청 파라미터

이름 설명 필수
api_key 발급받은 API KEY 필수
original_url 단축할 원본 URL 필수
link_title 링크 제목 선택
note 메모 선택
custom_alias 원하는 커스텀 주소 선택
open_at 예약 오픈 시간 (Y-m-d H:i:s) 선택
expires_at 만료일 (Y-m-d H:i:s) 선택
password 비밀번호 보호 설정 선택

CURL 예제

curl -X POST https://urlly.kr/api/create.php \
-d "api_key=YOUR_API_KEY" \
-d "original_url=https://example.com" \
-d "link_title=블로그 링크" \
-d "note=광고용 링크" \
-d "custom_alias=event2026" \
-d "open_at=2026-05-20 09:00:00" \
-d "expires_at=2026-12-31 23:59:59" \
-d "password=1234"

PHP 예제

<?php

$ch = curl_init();

curl_setopt_array($ch, [
    CURLOPT_URL => "https://urlly.kr/api/create.php",
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => http_build_query([
    'api_key' => 'YOUR_API_KEY',
    'original_url' => 'https://example.com',
    'link_title' => '블로그 링크',
    'note' => '광고용 링크',
    'custom_alias' => 'event2026',
    'expires_at' => '2026-12-31 23:59:59'
]),
    CURLOPT_RETURNTRANSFER => true
]);

$result = curl_exec($ch);

curl_close($ch);

echo $result;

Python 예제

import requests

res = requests.post(
    "https://urlly.kr/api/create.php",
    data={
        "api_key": "YOUR_API_KEY",
        "original_url": "https://example.com",
        "link_title": "블로그 링크",
        "note": "광고용 링크",
        "custom_alias": "event2026",
        "expires_at": "2026-12-31 23:59:59"
    }
)

print(res.json())

응답 예제

{
  "status":"success",
  "message":"단축URL 생성 완료",
  "data":{
      "link_id":123,
      "short_code":"event2026",
      "short_url":"https://urlly.kr/event2026",
      "qr_url":"https://urlly.kr/qr.php?code=event2026"
  }
}

오류 코드

상태 설명
API KEY 오류 유효하지 않은 API KEY
일일 API 사용량 초과 오늘 사용 제한 초과
월 API 사용량 초과 월 사용 제한 초과
차단된 도메인 운영정책상 차단된 URL

API 기능은 PRO 이상에서 제공됩니다

자동화 시스템, 마케팅 툴, 블로그 생성기, GPT 연동 등에 사용할 수 있습니다.

PRO 요금제 보기