Linkly의 링크 단축 API

Linkly의 링크 단축 API를 사용하여 프로그래밍 방식으로 링크를 생성, 업데이트 및 관리하세요.

관련: 분석 API | 웹훅

시작하기 전에

Linkly는 인터페이스에서 API 요청을 생성하여 애플리케이션에 복사하고 붙여넣을 수 있도록 합니다.

링크 생성 및 링크 업데이트에 작동합니다.

시간을 절약하고 어려운 작업을 맡기세요:

1. 1
   링크 생성 API 요청은 아래를 참조하세요.
2. 2
   요청을 전체적으로 복사합니다. 당신을 위해 작동하는지 확인할 수 있습니다.
3. 3
   ChatGPT 또는 이와 동등한 것에 이 요청들을 당신의 애플리케이션의 소스 코드로 조정해달라고 요청하세요. 복잡한 통합을 수행하는 데 시간을 소비할 필요가 없습니다. 당사의 API는 완전히 기계 가능합니다.

---

OpenAPI 3.0 사양

Linkly 사용자 인터페이스에서 직접 API 요청을 생성할 수 있습니다.

Linkly의 API는 OpenAPI 표준을 사용하여 문서화되어 있으며, 이는 아래에 제공된 것 이상입니다. 동일한 엔드포인트는 원클릭 Postman 컬렉션으로도 사용할 수 있습니다.

OpenAPI 사양 보기

Postman에서 실행

인증

다음이 필요합니다:

• API 키
• 워크스페이스 ID

이 세부 정보는 Linkly 내부에서 얻을 수 있습니다.

1. 1
   Linkly에 로그인합니다.
2. 2
   설정을 클릭합니다.
3. 3
   API 키를 클릭합니다.

링크 생성 또는 업데이트

링크를 생성하려면 다음 주소로 POST 요청을 보내기만 하면 됩니다:

https://app.linklyhq.com/api/v1/link

본문에 다음 필드를 포함합니다.

인코딩 유형은 x-www-form-urlencoded 또는 application/json입니다.

규칙 필드를 제출하는 경우 application/json을 사용해야 합니다.

개방형 API 사양과 함께 JSON을 사용하는 것이 좋습니다.

cURL을 사용한 요청 예제

아래 코드는 링크를 생성하기 위해 API 요청을 하는 방법을 보여줍니다.

curl -X POST https://app.linklyhq.com/api/v1/link
-H 'cache-control: no-cache'
-d 'api_key=your_secret_key&workspace_id=1&url=http%3A%2F%2Fwww.wikijob.co.uk&name=Test%20Link'

성공적인 응답은 링크를 나타내는 JSON 객체와 링크 ID를 반환합니다.

{
    "id": 9512,
    "url": "https://www.wikijob.co.uk",
    "name": "Test Link",
    "note": null,
    "head_tags": null,
    "body_tags": null,
    "linkify_words": null,
    "replacements": null,
    "enabled": true,
    "cloaking": false,
    "forward_params": false,
    "hide_referrer": false,
    "block_bots": false,
    "skip_social_crawler_tracking": false,
    "public_analytics": false,
    "password": null,
    "domain": null,
    "slug": null,
    "utm_source": null,
    "utm_medium": null,
    "utm_campaign": null,
    "utm_term": null,
    "utm_content": null,
    "og_title": null,
    "og_description": null,
    "og_image": null,
    "fb_pixel_id": null,
    "tiktok_pixel_id": null,
    "ga4_tag_id": null,
    "gtm_id": null,
    "full_url": "https://l.linklyhq.com/l/2TQ",
    "rules": [],
    "expiry_datetime": null,
    "expiry_destination": null,
    "expiry_clicks": null,
    "qr_styles": null,
    "webhooks": [],
    "notify_user_ids": [],
    "workspace_id": 1448,
    "deleted": false
}

링크 업데이트

링크를 업데이트하려면 링크를 생성할 때와 동일한 요청을 보내되, 업데이트할 링크의 id 필드 및 변경 사항을 포함합니다.

API를 통한 로테이터 생성

로테이터를 생성하려면 위의 링크 페이로드와 함께 rules이라는 필드를 JSON 배열로 제출합니다. JSON 배열을 보내려면 application/json을 사용해야 합니다.

예를 들어:

[
  {"what": "rotator", "url": "https://www.microsoft.com", "percentage": "50"},
  {"what": "rotator", "url": "https://www.apple.com", "percentage": "50"}
]

API를 통한 지역 리디렉션 생성

국가별로 리디렉션하려면 위의 링크 페이로드와 함께 rules이라는 필드를 JSON 배열로 제출합니다. JSON 배열을 보내려면 application/json 인코딩을 사용해야 합니다.

예를 들어:

[
  {"what": "country", "url": "https://www.microsoft.com", "matches": "UK"},
  {"what": "country", "url": "https://www.apple.com", "matches": "US"}
]

국가는 **알파-2 ISO 3166 국가 코드**입니다.

API를 통한 기기 리디렉션 생성

기기별로 리디렉션하려면 위의 링크 페이로드와 함께 rules이라는 필드를 JSON 배열로 제출합니다.

예를 들어:

[
  {"what": "platform", "url": "https://www.google.com", "matches": "windows"},
  {"what": "platform", "url": "https://www.apple.com", "matches": "ios"}
]

matches 필드는 다음 중 하나입니다:

• ios
• android
• windows
• linux
• mac

한 요청에서 여러 링크 생성 또는 업데이트

Linkly는 요청당 최대 1000개의 링크 생성/수정을 지원합니다.

이렇게 하려면 다음과 같이 요청의 일부로 API 키를 제출합니다:

https://app.linklyhq.com/api/v1/link?api_key=XXXXXXXXXXX

그런 다음 개별 링크 경우와 동일한 스키마를 사용하되 링크 요청을 다음 형태의 배열로 래핑합니다:

[{link}, {link}]

다음은 두 개의 링크를 업데이트하는 완전한 요청입니다:

wget --no-check-certificate \
  --method POST \
  --timeout=0 \
  --header 'Content-Type: application/json' \
  --body-data '[
    {
        "workspace_id": "WORKSPACE_ID",
        "url": "https://nature.com",
        "name": "Test",
        "id": LINK_ID
    },
    {
        "workspace_id": "WORKSPACE_ID",
        "url": "https://science.com",
        "id": LINK_ID
    }
]' \
   'https://app.linklyhq.com/api/v1/workspace/WORKSPACE_ID/links?api_key=API_KEY'

이는 생성 및 업데이트 작업 모두에 작동합니다.

대규모 요청의 경우 최대 60초가 걸릴 수 있습니다. 요청이 이보다 오래 걸리면 실패하며 워크로드를 더 작은 청크로 분할하는 것을 고려해야 합니다.

속도 제한

링크 단축 API는 초당 20개 요청으로 제한됩니다. 초당 최대 200개 요청을 요청하면 사용할 수 있습니다. 단일 요청에 최대 1000개의 링크를 업로드할 수 있습니다.

관련

• 분석 API - 클릭 데이터 및 트래픽 보고서 내보내기
• 웹훅 - 실시간 클릭 알림
• Zapier 통합 - 코드 없는 통합