공개 API는 워크스페이스 자산을 위한 서버 간 인터페이스입니다. 대시보드와 같은 권한 및 카운터를 사용하므로 플랜 제한을 우회하거나 별도 할당량을 얻지 않습니다.
1. 키 생성과 범위
설정 → API 키에서 만듭니다. 모든 플랜에서 사용하며 구독과 워크스페이스 범위에 연결됩니다. 비밀값은 서버 측에만 저장하세요.
https://api.shorturl.bot/v1에 Authorization: Bearer <api_key>를 보내고 먼저 GET /workspaces를 호출합니다.
2. 링크 생성
curl -X POST "https://api.shorturl.bot/v1/workspaces/WORKSPACE_ID/links" -H "Authorization: Bearer $SHORTURL_API_KEY" -H "Content-Type: application/json" -d '{"targetUrl":"https://example.com/launch","backHalf":"launch","tags":["email"]}'성공은 201입니다. domain 생략 시 기본값, 2s.gg는 기존 자산 전용입니다.
3. 플랜과 오류
- 전체: 생성, 태그, UTM, 사용자 지정 뒷부분.
- Go+: 상태와 최대 500개 일괄 생성.
- Plus+: 목적지, 예약, 만료, 리디렉션, 비밀번호.
- 전체: IP당 분당 800개 요청.
401 키 오류, 403 접근 거부, 429 제한입니다. 일시 오류만 재시도하세요.
다음
개발자 참고서를 확인하세요.