Meloming Logo
MELOM.INGDocs

빠른 시작 가이드

melom.ing을 사용하여 URL을 단축하고 성능을 추적하는 방법을 알아보세요.

웹에서 단축 URL 생성하기

1. 단축 URL 만들기

  1. melom.ing에 접속합니다
  2. 입력 필드에 긴 URL을 입력합니다
  3. 선택적으로 "고급 옵션"을 클릭하여 커스텀 코드를 설정합니다
  4. "URL 단축하기" 버튼을 클릭합니다
  5. 새로운 단축 URL을 복사하여 공유하세요!

2. URL 통계 보기

  1. melom.ing/info/YOUR_CODE melom.ing/info/코드로 이동하여 기본 정보를 확인합니다
  2. "통계 보기"를 클릭하여 상세 분석을 봅니다
  3. 일일 클릭, 기기, 브라우저 등을 확인합니다

API 사용하기

단축 URL 생성

curl 또는 HTTP 클라이언트를 사용하여 프로그래밍 방식으로 단축 URL을 생성합니다:

curl -X POST https://api.melom.ing/api/v1/urls \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/my/very/long/url"
  }'

응답

{
  "success": true,
  "data": {
    "code": "abc123",
    "short_url": "https://melom.ing/abc123",
    "original_url": "https://example.com/my/very/long/url",
    "created_at": "2024-12-19T10:30:00Z"
  }
}

커스텀 코드로 생성

curl -X POST https://api.melom.ing/api/v1/urls \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/my/very/long/url",
    "custom_code": "my-link"
  }'

코드 사용 가능 여부 확인

curl https://api.melom.ing/api/v1/urls/check/my-link

URL 통계 조회

curl https://api.melom.ing/api/v1/urls/abc123/stats

코드 예제

JavaScript / TypeScript

async function shortenURL(url: string) {
  const response = await fetch('https://api.melom.ing/api/v1/urls', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ url }),
  });

  const data = await response.json();

  if (!data.success) {
    throw new Error(data.error.message);
  }

  return data.data;
}

// Usage
const result = await shortenURL('https://example.com/long/url');
console.log(result.short_url);
// Output: https://melom.ing/abc123

Python

import requests

def shorten_url(url: str) -> dict:
    response = requests.post(
        'https://api.melom.ing/api/v1/urls',
        json={'url': url}
    )
    data = response.json()

    if not data['success']:
        raise Exception(data['error']['message'])

    return data['data']

# Usage
result = shorten_url('https://example.com/long/url')
print(result['short_url'])
# Output: https://melom.ing/abc123

Go

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
)

type CreateURLRequest struct {
    URL string `json:"url"`
}

type URLResponse struct {
    Code     string `json:"code"`
    ShortURL string `json:"short_url"`
}

func shortenURL(url string) (*URLResponse, error) {
    body, _ := json.Marshal(CreateURLRequest{URL: url})

    resp, err := http.Post(
        "https://api.melom.ing/api/v1/urls",
        "application/json",
        bytes.NewBuffer(body),
    )
    if err != nil {
        return nil, err
    }
    defer resp.Body.Close()

    var result struct {
        Success bool         `json:"success"`
        Data    URLResponse  `json:"data"`
    }
    json.NewDecoder(resp.Body).Decode(&result)

    return &result.Data, nil
}

func main() {
    result, _ := shortenURL("https://example.com/long/url")
    fmt.Println(result.ShortURL)
    // Output: https://melom.ing/abc123
}

모범 사례

  • 브랜드 링크에 커스텀 코드 사용: 마케팅 캠페인에 melom.ing/my-product와 같이 기억하기 쉬운 코드를 만드세요.
  • 먼저 코드 사용 가능 여부 확인: 커스텀 코드로 URL을 생성하기 전에 check 엔드포인트로 사용 가능 여부를 확인하세요.
  • 임시 링크에 만료 설정: 기간 한정 프로모션에 expires_at 파라미터를 사용하세요.
  • 통계 모니터링: 정기적으로 클릭 통계를 확인하여 오디언스를 이해하고 링크를 최적화하세요.

사용량 제한

모두가 공정하게 사용할 수 있도록 API에는 사용량 제한이 있습니다:

  • URL 생성: 시간당 5회

더 높은 제한이 필요하시면 meloming@dylabs.app으로 문의해주세요.