| All Verbs | /overview |
|---|
import datetime
import decimal
from marshmallow.fields import *
from servicestack import *
from typing import *
from dataclasses import dataclass, field
from dataclasses_json import dataclass_json, LetterCase, Undefined, config
from enum import Enum, IntEnum
Object = TypeVar('Object')
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class UserInfo:
user_name: Optional[str] = None
avatar_url: Optional[str] = None
stacks_count: int = 0
class TechnologyTier(str, Enum):
PROGRAMMING_LANGUAGE = 'ProgrammingLanguage'
CLIENT = 'Client'
HTTP = 'Http'
SERVER = 'Server'
DATA = 'Data'
SOFTWARE_INFRASTRUCTURE = 'SoftwareInfrastructure'
OPERATING_SYSTEM = 'OperatingSystem'
HARDWARE_INFRASTRUCTURE = 'HardwareInfrastructure'
THIRD_PARTY_SERVICES = 'ThirdPartyServices'
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class TechnologyInfo:
tier: Optional[TechnologyTier] = None
slug: Optional[str] = None
name: Optional[str] = None
logo_url: Optional[str] = None
stacks_count: int = 0
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class TechnologyStackBase:
id: int = 0
name: Optional[str] = None
vendor_name: Optional[str] = None
description: Optional[str] = None
app_url: Optional[str] = None
screenshot_url: Optional[str] = None
created: datetime.datetime = datetime.datetime(1, 1, 1)
created_by: Optional[str] = None
last_modified: datetime.datetime = datetime.datetime(1, 1, 1)
last_modified_by: Optional[str] = None
is_locked: bool = False
owner_id: Optional[str] = None
slug: Optional[str] = None
# @StringLength(2147483647)
details: Optional[str] = None
# @StringLength(2147483647)
details_html: Optional[str] = None
last_status_update: Optional[datetime.datetime] = None
organization_id: Optional[int] = None
comments_post_id: Optional[int] = None
view_count: int = 0
fav_count: int = 0
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class TechnologyBase:
id: int = 0
name: Optional[str] = None
vendor_name: Optional[str] = None
vendor_url: Optional[str] = None
product_url: Optional[str] = None
logo_url: Optional[str] = None
description: Optional[str] = None
created: datetime.datetime = datetime.datetime(1, 1, 1)
created_by: Optional[str] = None
last_modified: datetime.datetime = datetime.datetime(1, 1, 1)
last_modified_by: Optional[str] = None
owner_id: Optional[str] = None
slug: Optional[str] = None
logo_approved: bool = False
is_locked: bool = False
tier: Optional[TechnologyTier] = None
last_status_update: Optional[datetime.datetime] = None
organization_id: Optional[int] = None
comments_post_id: Optional[int] = None
view_count: int = 0
fav_count: int = 0
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class TechnologyInStack(TechnologyBase):
technology_id: int = 0
technology_stack_id: int = 0
justification: Optional[str] = None
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class TechStackDetails(TechnologyStackBase):
technology_choices: List[TechnologyInStack] = field(default_factory=list)
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class TechnologyStack(TechnologyStackBase):
pass
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class LabelInfo:
slug: Optional[str] = None
color: Optional[str] = None
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class CategoryInfo:
id: int = 0
name: Optional[str] = None
slug: Optional[str] = None
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class OrganizationInfo:
id: int = 0
name: Optional[str] = None
slug: Optional[str] = None
ref_id: Optional[int] = None
ref_source: Optional[str] = None
up_votes: Optional[int] = None
down_votes: Optional[int] = None
members_count: int = 0
rank: int = 0
disable_invites: Optional[bool] = None
lang: Optional[str] = None
post_types: List[str] = field(default_factory=list)
moderator_post_types: List[str] = field(default_factory=list)
locked: Optional[datetime.datetime] = None
labels: List[LabelInfo] = field(default_factory=list)
categories: List[CategoryInfo] = field(default_factory=list)
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class OverviewResponse:
created: datetime.datetime = datetime.datetime(1, 1, 1)
top_users: List[UserInfo] = field(default_factory=list)
top_technologies: List[TechnologyInfo] = field(default_factory=list)
latest_tech_stacks: List[TechStackDetails] = field(default_factory=list)
popular_tech_stacks: List[TechnologyStack] = field(default_factory=list)
all_organizations: List[OrganizationInfo] = field(default_factory=list)
top_technologies_by_tier: Dict[str, List[TechnologyInfo]] = field(default_factory=dict)
response_status: Optional[ResponseStatus] = None
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class Overview(IGet):
reload: bool = False
To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
POST /overview HTTP/1.1
Host: techstacks.io
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length
{
reload: False
}
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length
{
created: 0001-01-01,
topUsers:
[
{
userName: String,
avatarUrl: String,
stacksCount: 0
}
],
topTechnologies:
[
{
tier: ProgrammingLanguage,
slug: String,
name: String,
logoUrl: String,
stacksCount: 0
}
],
latestTechStacks:
[
{
technologyChoices:
[
{
technologyId: 0,
technologyStackId: 0,
justification: String,
id: 0,
name: String,
vendorName: String,
vendorUrl: String,
productUrl: String,
logoUrl: String,
description: String,
created: 0001-01-01,
createdBy: String,
lastModified: 0001-01-01,
lastModifiedBy: String,
ownerId: String,
slug: String,
logoApproved: False,
isLocked: False,
tier: ProgrammingLanguage,
lastStatusUpdate: 0001-01-01,
organizationId: 0,
commentsPostId: 0,
viewCount: 0,
favCount: 0
}
],
id: 0,
name: String,
vendorName: String,
description: String,
appUrl: String,
screenshotUrl: String,
created: 0001-01-01,
createdBy: String,
lastModified: 0001-01-01,
lastModifiedBy: String,
isLocked: False,
ownerId: String,
slug: String,
details: String,
detailsHtml: String,
lastStatusUpdate: 0001-01-01,
organizationId: 0,
commentsPostId: 0,
viewCount: 0,
favCount: 0
}
],
popularTechStacks:
[
{
id: 0,
name: String,
vendorName: String,
description: String,
appUrl: String,
screenshotUrl: String,
created: 0001-01-01,
createdBy: String,
lastModified: 0001-01-01,
lastModifiedBy: String,
isLocked: False,
ownerId: String,
slug: String,
details: String,
detailsHtml: String,
lastStatusUpdate: 0001-01-01,
organizationId: 0,
commentsPostId: 0,
viewCount: 0,
favCount: 0
}
],
allOrganizations:
[
{
id: 0,
name: String,
slug: String,
refId: 0,
refSource: String,
upVotes: 0,
downVotes: 0,
membersCount: 0,
rank: 0,
disableInvites: False,
lang: String,
postTypes:
[
String
],
moderatorPostTypes:
[
String
],
locked: 0001-01-01,
labels:
[
{
slug: String,
color: String
}
],
categories:
[
{
id: 0,
name: String,
slug: String
}
]
}
],
topTechnologiesByTier:
{
String:
[
{
tier: ProgrammingLanguage,
slug: String,
name: String,
logoUrl: String,
stacksCount: 0
}
]
},
responseStatus:
{
errorCode: String,
message: String,
stackTrace: String,
errors:
[
{
errorCode: String,
fieldName: String,
message: String,
meta:
{
String: String
}
}
],
meta:
{
String: String
}
}
}