Skip to content

Latest commit

 

History

History
22 lines (11 loc) · 1.02 KB

FAQ.md

File metadata and controls

22 lines (11 loc) · 1.02 KB

FAQ

For now, we'll use this doc to capture things we decided against for the Design Guide.

Why not use "seconds since epoch" instead of RFC3339?

[2016 Mar 10] Seconds since epoch can be ambiguous, due to different definitions of epoch starting point and varying support for leap-seconds and other such nerd tomfoolery.

How about versioning services by standing up a separate service per version?

[2016 Mar 10] An interesting idea that may be feasible given the right infrastructure.

Heroku's API Design Guide states a preference for hyphens over underscores in URI paths, how about in ours?

[2016 Mar 10] While there is some support for this, particularly in public endpoints, our existing services already favor the underscore.

Since the point of a standard is consistency, and we're already consistent at this point, yada yada yada.

(**GET /offers/{offer_type}-{offer_id}.json)