apis-json/api-json

API Property Types

kinlane opened this issue · 4 comments

Here are my suggestions for next round of API property types:

GettingStarted
FrequentlyAskedQuestions
Signup
BestPractices
ServiceAccord
Documentation
Explorer
ErrorCodes
AuthenticationOverview
AuthenticationTester
CodeLibraries
ApplicationGallery
SoftwareDevelopmentKits
StackExchange
Calendar
OfficeHours
Blog
BlogRSS
LinkedIn
Twitter
Github
Facebook
GooglePlus
Roadmap
ChangeLog
RateLimits
Affiliate
Advertising
CaseStudies
WhitePapers
HowToGuides
Webinars
Ideas
Labs
Opportunities
Branding
PrivacyPolicy
ServiceLevelAgreement
DataLicense
CodeLicense
DeprecationPolicy
Widgets
Buttons
Badges

These are priorities I feel:

GettingStarted
Signup
Documentation
ErrorCodes
AuthenticationOverview
AuthenticationTester
CodeLibraries
ApplicationGallery
SoftwareDevelopmentKits
Blog
BlogRSS
LinkedIn
Twitter
Github
Facebook
GooglePlus
RateLimits
ServiceLevelAgreement
DataLicense
CodeLicense

To accepted by next version:

currently have:

Swagger
RAML
Blueprint
WADL
WSDL
TermsOfService
InterfaceLicense
StatusPage
Pricing
Forums
AlertsTwitterHandle

add next round:

GettingStarted
Signup
Documentation
ErrorCodes
AuthenticationOverview
AuthenticationTester
CodeLibraries
ApplicationGallery
SoftwareDevelopmentKits
Blog
BlogRSS
LinkedIn
Twitter
Github
Facebook
GooglePlus
RateLimits
ServiceLevelAgreement
DataLicense
CodeLicense
APICommonsManifest

Adam Avilla adam@avil.la via googlegroups.com - Sep 24

We are looking to incorporate this for an internal API search engine (company specific APIs) and have identified some fields that we would like to store. I would like to hear your suggested data models for them or if I can contribute to specifying them.

Need:

  • URI Port
  • Source code link
  • Code version
  • Last time deployed
  • Software dependencies
  • Ticket tracking URL

Mostly all of these would be optional. Let me know if there are more questions or if I can be more specific.

Thanks Kin.