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입니다.

Rules 필드를 제출하는 경우 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'

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

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