Zagl 로고

API 문서

코드에서 바로 링크를 줄이세요. 엔드포인트 하나, 베어러 토큰 하나면 끝입니다.

엔드포인트

POSThttps://za.gl/api/shorten
RESTJSON 본문베어러 인증

인증

API 토큰을 Authorization 헤더에 베어러 토큰으로 넣으세요. 첫 링크를 만든 뒤 계정 대시보드에서 가져올 수 있습니다.

헤더
Authorization: Bearer YOUR_API_TOKEN

토큰이 아직 없나요? 없어도 엔드포인트를 호출할 수 있습니다. Za.gl이 익명 계정을 바로 만들고 새 토큰을 data.newAuthToken. 에 담아 돌려줍니다. 나중에 링크를 관리하려면 저장해 두세요.

요청 본문

originalUrl필수

string

줄일 긴 URL입니다. 프로토콜을 빼면 https:// 가 자동으로 붙습니다.

customAlias

string

직접 정하는 뒷부분입니다. 예: za.gl/my-link. 중복되면 409가 돌아옵니다.

password

string

링크를 보호해 방문자가 비밀번호를 입력해야 계속할 수 있게 합니다.

expiresAt

string (ISO date)

링크가 작동을 멈출 시점입니다. 미래 시각이어야 합니다.

expiresInMinutes / expiresInHours / expiresInDays

number

expiresAt 대신 쓰는 값으로, 지정한 시간이 지나면 만료됩니다.

waitTimer

number (0-300)

리디렉션 전에 방문자가 미리보기 페이지에서 기다리는 초입니다.

customGtmId

string

미리보기 페이지에서 실행되는 본인의 Google Tag Manager ID (GTM-XXXXXXX)입니다.

title / description

string

링크와 함께 저장되는 선택 메타데이터입니다.

generateQR

boolean

단축 URL의 QR 코드도 함께 반환합니다.

요청 예시

POSTcURL
curl -X POST https://za.gl/api/shorten \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "originalUrl": "https://example.com/a-very-long-link",
    "customAlias": "my-link",
    "password": "optional-secret",
    "expiresAt": "2026-12-31T23:59:59.000Z",
    "waitTimer": 5
  }'

응답 예시

호출에 성공하면 200 OK 이 반환되고, 단축 URL은 다음 필드에 담깁니다: data.shortUrl.

200 OKJSON
{
  "success": true,
  "message": "URL shortened successfully",
  "data": {
    "id": "123",
    "alias": "my-link",
    "shortUrl": "https://za.gl/my-link",
    "originalUrl": "https://example.com/a-very-long-link",
    "customAlias": "my-link",
    "domain": "za.gl",
    "title": "",
    "description": null,
    "hasPassword": true,
    "isActive": true,
    "expiresAt": "2026-12-31T23:59:59.000Z",
    "hits": 0,
    "waitTimer": 5,
    "created": "2026-06-25T10:00:00.000Z",
    "modified": "2026-06-25T10:00:00.000Z",
    "authToken": "your-account-token"
  }
}

요청 제한과 오류

10 req/min클라이언트당 분당 최대 10회 요청.
409이미 사용 중인 별칭입니다.
400잘못된 URL이거나 만료일이 과거입니다.
429요청 제한 또는 월 할당량을 넘었습니다.