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을 사용해야 합니다.

Open 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 통합 - 코드 없는 통합