{"openapi":"3.1.0","info":{"title":"srrrg API","description":"srrrg 단축 URL API","version":"v1"},"servers":[{"url":"https://dev.srrrg.link","description":"Generated server url"}],"tags":[{"name":"Links","description":"단축 링크 관리 API"}],"paths":{"/api/v1/projects/{projectId}/utm-templates":{"get":{"tags":["UTM templates"],"operationId":"list","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/UtmTemplateResponse"}}}}}}},"post":{"tags":["UTM templates"],"operationId":"create","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateUtmTemplateRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/UtmTemplateResponse"}}}}}}},"/api/v1/projects/{projectId}/utm-templates/{templateId}/fields":{"post":{"tags":["UTM templates"],"operationId":"addField","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"templateId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateUtmTemplateFieldRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/UtmTemplateFieldResponse"}}}}}}},"/api/v1/projects/{projectId}/links":{"get":{"tags":["Project links"],"summary":"List project links","operationId":"list_1","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":50}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/LinkPageResponse"}}}}},"security":[{"projectApiKey":[]}]},"post":{"tags":["Project links"],"summary":"Create a project link","operationId":"create_1","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateLinkRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/LinkResponse"}}}}},"security":[{"projectApiKey":[]}]}},"/api/v1/projects/{projectId}/campaigns":{"get":{"tags":["Campaigns"],"operationId":"list_2","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":50}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CampaignPageResponse"}}}}}},"post":{"tags":["Campaigns"],"operationId":"create_2","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCampaignRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CampaignResponse"}}}}}}},"/api/v1/campaigns/{campaignId}/links":{"get":{"tags":["public-campaign-link-controller"],"operationId":"list_3","parameters":[{"name":"campaignId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":50}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CampaignLinkPageResponse"}}}}}},"post":{"tags":["public-campaign-link-controller"],"operationId":"create_3","parameters":[{"name":"campaignId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCampaignLinkRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CampaignLinkResponse"}}}}}}},"/api/v1/campaigns/{campaignId}/links/batch":{"post":{"tags":["public-campaign-link-controller"],"operationId":"createBatch","parameters":[{"name":"campaignId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CreateCampaignLinkRequest"}}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CampaignLinkResponse"}}}}}}}},"/api/v1/campaigns/{campaignId}/imports/csv":{"post":{"tags":["public-campaign-csv-controller"],"operationId":"upload","parameters":[{"name":"campaignId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary"}},"required":["file"]}}}},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CsvUploadResponse"}}}}}}},"/api/links":{"post":{"tags":["Links"],"summary":"단축 링크 생성","description":"원본 URL을 등록하고 단축 URL과 관리용 secret key를 발급합니다.","operationId":"create_4","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateLinkRequest"}}},"required":true},"responses":{"201":{"description":"생성 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CreateLinkResponse"}}}},"400":{"description":"잘못된 URL, 만료 시각 또는 위협 URL","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CreateLinkResponse"}}}},"429":{"description":"요청 한도 초과","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CreateLinkResponse"}}}},"503":{"description":"URL 안전 검사 불가","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CreateLinkResponse"}}}}}}},"/api/v1/projects/{projectId}/utm-templates/{templateId}":{"get":{"tags":["UTM templates"],"operationId":"get","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"templateId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/UtmTemplateResponse"}}}}}},"delete":{"tags":["UTM templates"],"operationId":"delete","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"templateId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK"}}},"patch":{"tags":["UTM templates"],"operationId":"rename","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"templateId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateUtmTemplateRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/UtmTemplateResponse"}}}}}}},"/api/v1/campaigns/{campaignId}":{"get":{"tags":["Campaigns"],"operationId":"get_1","parameters":[{"name":"campaignId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CampaignResponse"}}}}}},"patch":{"tags":["Campaigns"],"operationId":"update","parameters":[{"name":"campaignId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCampaignRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CampaignResponse"}}}}}}},"/api/v1/campaigns/{campaignId}/utm-template":{"patch":{"tags":["public-campaign-utm-controller"],"operationId":"select","parameters":[{"name":"campaignId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SelectTemplateRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CampaignResponse"}}}}}}},"/api/v1/campaigns/{campaignId}/utm-defaults":{"get":{"tags":["public-campaign-utm-controller"],"operationId":"defaults","parameters":[{"name":"campaignId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object","additionalProperties":{"type":"string"}}}}}}},"patch":{"tags":["public-campaign-utm-controller"],"operationId":"update_1","parameters":[{"name":"campaignId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateUtmDefaultsRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object","additionalProperties":{"type":"string"}}}}}}}},"/api/links/{code}":{"get":{"tags":["Links"],"summary":"단축 링크 관리 정보 조회","description":"단축 코드와 secret key로 링크 정보와 누적 통계를 조회합니다.","operationId":"getManagedLink","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Srrrg-Secret-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/LinkManagementResponse"}}}},"400":{"description":"secret key 헤더 누락","content":{"*/*":{"schema":{"$ref":"#/components/schemas/LinkManagementResponse"}}}},"404":{"description":"링크 없음 또는 secret key 불일치","content":{"*/*":{"schema":{"$ref":"#/components/schemas/LinkManagementResponse"}}}},"410":{"description":"삭제된 링크","content":{"*/*":{"schema":{"$ref":"#/components/schemas/LinkManagementResponse"}}}}}},"delete":{"tags":["Links"],"summary":"단축 링크 삭제","description":"secret key로 인증한 뒤 링크를 soft delete합니다.","operationId":"deleteManagedLink","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Srrrg-Secret-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"삭제 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/DeleteLinkResponse"}}}},"400":{"description":"secret key 헤더 누락","content":{"*/*":{"schema":{"$ref":"#/components/schemas/DeleteLinkResponse"}}}},"404":{"description":"링크 없음 또는 secret key 불일치","content":{"*/*":{"schema":{"$ref":"#/components/schemas/DeleteLinkResponse"}}}},"410":{"description":"이미 삭제된 링크","content":{"*/*":{"schema":{"$ref":"#/components/schemas/DeleteLinkResponse"}}}}}},"patch":{"tags":["Links"],"summary":"단축 링크 수정","description":"secret key로 인증한 뒤 원본 URL 또는 만료 시각을 수정합니다.","operationId":"updateManagedLink","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Srrrg-Secret-Key","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateLinkRequest"}}},"required":true},"responses":{"200":{"description":"수정 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/LinkManagementResponse"}}}},"400":{"description":"잘못된 요청 또는 위협 URL","content":{"*/*":{"schema":{"$ref":"#/components/schemas/LinkManagementResponse"}}}},"404":{"description":"링크 없음 또는 secret key 불일치","content":{"*/*":{"schema":{"$ref":"#/components/schemas/LinkManagementResponse"}}}},"410":{"description":"삭제된 링크","content":{"*/*":{"schema":{"$ref":"#/components/schemas/LinkManagementResponse"}}}},"503":{"description":"URL 안전 검사 불가","content":{"*/*":{"schema":{"$ref":"#/components/schemas/LinkManagementResponse"}}}}}}},"/api/v1/projects/{projectId}/statistics":{"get":{"tags":["public-statistics-controller"],"operationId":"project","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"bucket","in":"query","required":false,"schema":{"type":"string","default":"DAY","enum":["DAY","MONTH","YEAR"]}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":50}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/StatisticsResponse"}}}}}}},"/api/v1/projects/{projectId}/links/{code}/statistics":{"get":{"tags":["public-statistics-controller"],"operationId":"projectLink","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"code","in":"path","required":true,"schema":{"type":"string"}},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"bucket","in":"query","required":false,"schema":{"type":"string","default":"DAY","enum":["DAY","MONTH","YEAR"]}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":50}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/StatisticsResponse"}}}}}}},"/api/v1/campaigns/{campaignId}/statistics":{"get":{"tags":["public-statistics-controller"],"operationId":"campaign","parameters":[{"name":"campaignId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"bucket","in":"query","required":false,"schema":{"type":"string","default":"DAY","enum":["DAY","MONTH","YEAR"]}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":50}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/StatisticsResponse"}}}}}}},"/api/v1/campaigns/{campaignId}/links/template.csv":{"get":{"tags":["public-campaign-csv-controller"],"operationId":"template","parameters":[{"name":"campaignId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"text/csv":{"schema":{"type":"string","format":"byte"}}}}}}},"/api/v1/campaigns/{campaignId}/links.csv":{"get":{"tags":["public-campaign-csv-controller"],"operationId":"export","parameters":[{"name":"campaignId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"createdFrom","in":"query","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"createdTo","in":"query","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"externalId","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"text/csv":{"schema":{"type":"string","format":"byte"}}}}}}},"/api/links/{code}/statistics":{"get":{"tags":["anonymous-statistics-controller"],"operationId":"link","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Srrrg-Secret-Key","in":"header","required":true,"schema":{"type":"string"}},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"bucket","in":"query","required":false,"schema":{"type":"string","default":"DAY","enum":["DAY","MONTH","YEAR"]}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":50}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/StatisticsResponse"}}}}}}},"/api/v1/projects/{projectId}/utm-templates/{templateId}/fields/{fieldId}":{"delete":{"tags":["UTM templates"],"operationId":"deleteField","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"templateId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"fieldId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK"}}}}},"components":{"schemas":{"CreateUtmTemplateRequest":{"type":"object","properties":{"name":{"type":"string","maxLength":100,"minLength":0}},"required":["name"]},"UtmTemplateFieldResponse":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"name":{"type":"string"}}},"UtmTemplateResponse":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"name":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"activeFields":{"type":"array","items":{"$ref":"#/components/schemas/UtmTemplateFieldResponse"}}}},"CreateUtmTemplateFieldRequest":{"type":"object","properties":{"name":{"type":"string","maxLength":50,"minLength":0}},"required":["name"]},"CreateLinkRequest":{"type":"object","properties":{"originalUrl":{"type":"string","maxLength":2048,"minLength":0},"expiresAt":{"type":"string","format":"date-time"},"name":{"type":"string","maxLength":100,"minLength":0}},"required":["originalUrl"]},"LinkResponse":{"type":"object","properties":{"code":{"type":"string"},"name":{"type":"string"},"originalUrl":{"type":"string"},"expiresAt":{"type":"string","format":"date-time"},"createdAt":{"type":"string","format":"date-time"}}},"CreateCampaignRequest":{"type":"object","properties":{"name":{"type":"string","maxLength":100,"minLength":0},"description":{"type":"string","maxLength":500,"minLength":0},"defaultOriginalUrl":{"type":"string","maxLength":2048,"minLength":0}},"required":["name"]},"CampaignResponse":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"name":{"type":"string"},"description":{"type":"string"},"defaultOriginalUrl":{"type":"string"},"utmTemplateId":{"type":"integer","format":"int64"},"utmTemplateName":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}},"CreateCampaignLinkRequest":{"type":"object","properties":{"originalUrl":{"type":"string","maxLength":2048,"minLength":0},"expiresAt":{"type":"string","format":"date-time"},"externalId":{"type":"string","maxLength":100,"minLength":0},"utmValues":{"type":"object","additionalProperties":{"type":"string"}},"name":{"type":"string","maxLength":100,"minLength":0}}},"CampaignLinkResponse":{"type":"object","properties":{"code":{"type":"string"},"name":{"type":"string"},"originalUrl":{"type":"string"},"externalId":{"type":"string"},"createdAt":{"type":"string","format":"date-time"}}},"CsvUploadResponse":{"type":"object","properties":{"totalRows":{"type":"integer","format":"int32"},"createdRows":{"type":"integer","format":"int32"}}},"CreateLinkResponse":{"type":"object","properties":{"code":{"type":"string"},"shortUrl":{"type":"string"},"secretKey":{"type":"string"},"expiresAt":{"type":"string","format":"date-time"}}},"UpdateCampaignRequest":{"type":"object","properties":{"namePresent":{"type":"boolean"},"descriptionPresent":{"type":"boolean"},"defaultOriginalUrlPresent":{"type":"boolean"},"name":{"type":"string"},"description":{"type":"string"},"defaultOriginalUrl":{"type":"string"}}},"SelectTemplateRequest":{"type":"object","properties":{"utmTemplateId":{"type":"integer","format":"int64"}}},"UpdateUtmDefaultsRequest":{"type":"object","properties":{"defaults":{"type":"object","additionalProperties":{"type":"string"}}}},"UpdateLinkRequest":{"type":"object","properties":{"originalUrlPresent":{"type":"boolean"},"expiresAtPresent":{"type":"boolean"},"originalUrl":{"type":"string"},"expiresAt":{"type":"string","format":"date-time"}}},"LinkManagementResponse":{"type":"object","properties":{"code":{"type":"string"},"name":{"type":"string"},"shortUrl":{"type":"string"},"originalUrl":{"type":"string"},"campaignId":{"type":"integer","format":"int64"},"editable":{"type":"boolean"},"expiresAt":{"type":"string","format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}},"Breakdown":{"type":"object","properties":{"name":{"type":"string"},"count":{"type":"integer","format":"int64"},"share":{"type":"number","format":"double"}}},"CampaignRow":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"name":{"type":"string"},"links":{"type":"integer","format":"int64"},"period":{"$ref":"#/components/schemas/PeriodMetrics"}}},"LifetimeLinkSummary":{"type":"object","properties":{"total":{"type":"integer","format":"int64"},"humanAccessed":{"type":"integer","format":"int64"},"botOnly":{"type":"integer","format":"int64"},"noAccess":{"type":"integer","format":"int64"},"standalone":{"type":"integer","format":"int64"},"campaign":{"type":"integer","format":"int64"}}},"LinkRow":{"type":"object","properties":{"code":{"type":"string"},"externalId":{"type":"string"},"destinationSource":{"type":"string","enum":["LINK","CAMPAIGN_DEFAULT"]},"lifetimeStatus":{"type":"string","enum":["HUMAN_ACCESSED","BOT_ONLY","NO_ACCESS"]},"period":{"$ref":"#/components/schemas/PeriodMetrics"},"firstAccessedAt":{"type":"string","format":"date-time"},"lastAccessedAt":{"type":"string","format":"date-time"}}},"OutcomeBreakdown":{"type":"object","properties":{"outcome":{"type":"string","enum":["REDIRECTED","BLOCKED","CHECK_FAILED","URL_CHANGED","EXPIRED"]},"count":{"type":"integer","format":"int64"},"share":{"type":"number","format":"double"}}},"PageResultCampaignRow":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/CampaignRow"}},"nextOffset":{"type":"integer","format":"int32"},"totalItems":{"type":"integer","format":"int64"}}},"PageResultLinkRow":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/LinkRow"}},"nextOffset":{"type":"integer","format":"int32"},"totalItems":{"type":"integer","format":"int64"}}},"PageResultUtmRow":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/UtmRow"}},"nextOffset":{"type":"integer","format":"int32"},"totalItems":{"type":"integer","format":"int64"}}},"PeriodMetrics":{"type":"object","properties":{"entries":{"type":"integer","format":"int64"},"redirects":{"type":"integer","format":"int64"},"humanEntries":{"type":"integer","format":"int64"},"humanRedirects":{"type":"integer","format":"int64"},"botEntries":{"type":"integer","format":"int64"},"botRedirects":{"type":"integer","format":"int64"},"nonRedirects":{"type":"integer","format":"int64"}}},"RecentActivity":{"type":"object","properties":{"accessedAt":{"type":"string","format":"date-time"},"outcome":{"type":"string","enum":["REDIRECTED","BLOCKED","CHECK_FAILED","URL_CHANGED","EXPIRED"]},"referrerDomain":{"type":"string"},"device":{"type":"string"},"browser":{"type":"string"}}},"StatisticsResponse":{"type":"object","properties":{"scope":{"type":"string","enum":["LINK","CAMPAIGN","PROJECT"]},"name":{"type":"string"},"from":{"type":"string","format":"date"},"to":{"type":"string","format":"date"},"bucket":{"type":"string","enum":["DAY","MONTH","YEAR"]},"summary":{"$ref":"#/components/schemas/Summary"},"trend":{"type":"array","items":{"$ref":"#/components/schemas/TrendPoint"}},"outcomes":{"type":"array","items":{"$ref":"#/components/schemas/OutcomeBreakdown"}},"referrers":{"type":"array","items":{"$ref":"#/components/schemas/Breakdown"}},"devices":{"type":"array","items":{"$ref":"#/components/schemas/Breakdown"}},"browsers":{"type":"array","items":{"$ref":"#/components/schemas/Breakdown"}},"operatingSystems":{"type":"array","items":{"$ref":"#/components/schemas/Breakdown"}},"recentActivity":{"type":"array","items":{"$ref":"#/components/schemas/RecentActivity"}},"links":{"$ref":"#/components/schemas/PageResultLinkRow"},"utm":{"$ref":"#/components/schemas/PageResultUtmRow"},"campaigns":{"$ref":"#/components/schemas/PageResultCampaignRow"}}},"Summary":{"type":"object","properties":{"current":{"$ref":"#/components/schemas/PeriodMetrics"},"previous":{"$ref":"#/components/schemas/PeriodMetrics"},"lifetimeLinks":{"$ref":"#/components/schemas/LifetimeLinkSummary"}}},"TrendPoint":{"type":"object","properties":{"periodStart":{"type":"string","format":"date"},"entries":{"type":"integer","format":"int64"},"redirects":{"type":"integer","format":"int64"},"humanEntries":{"type":"integer","format":"int64"},"humanRedirects":{"type":"integer","format":"int64"},"botEntries":{"type":"integer","format":"int64"},"botRedirects":{"type":"integer","format":"int64"}}},"UtmRow":{"type":"object","properties":{"field":{"type":"string"},"value":{"type":"string"},"configuredLinks":{"type":"integer","format":"int64"},"lifetimeRedirectedLinks":{"type":"integer","format":"int64"},"lifetimeBotOnlyRedirectedLinks":{"type":"integer","format":"int64"},"redirectedEvents":{"type":"integer","format":"int64"}}},"LinkPageResponse":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/LinkResponse"}},"nextCursor":{"type":"integer","format":"int64"}}},"CampaignPageResponse":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/CampaignResponse"}},"nextCursor":{"type":"integer","format":"int64"}}},"CampaignLinkPageResponse":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/CampaignLinkResponse"}},"nextCursor":{"type":"integer","format":"int64"}}},"DeleteLinkResponse":{"type":"object","properties":{"deleted":{"type":"boolean"}}}},"securitySchemes":{"projectApiKey":{"type":"http","scheme":"bearer","bearerFormat":"API key"}}}}