{
    "version" : "https://jsonfeed.org/version/1",
    "content" : "news",
    "type" : "single",
    "title" : "Hot off the Press: 18F’s API Standards |Digital.gov",
    "description": "Hot off the Press: 18F’s API Standards",
    "home_page_url" : "/preview/gsa/digitalgov.gov/bc-archive-content-3/","feed_url" : "/preview/gsa/digitalgov.gov/bc-archive-content-3/2014/07/16/hot-off-the-press-18fs-api-standards/index.json","item" : [
    {"title" :"Hot off the Press: 18F’s API Standards","summary" : "We recently released the first version of our API Standards—a set of recommendations and guidelines for API production. It is our intention that every 18F API meet these standards, to help us ensure a baseline quality and consistency across all APIs we offer now and in the future. These standards guide","date" : "2014-07-16T13:00:03-04:00","date_modified" : "2025-01-27T19:42:55-05:00","authors" : {"alan-delevie" : "Alan DeLevie","eric-mill" : "Eric Mill"},"topics" : {
        
            "application-programming-interface" : "Application programming interface"
            },"branch" : "bc-archive-content-3",
      "filename" :"2014-07-16-hot-off-the-press-18fs-api-standards.md",
      
      "filepath" :"news/2014/07/2014-07-16-hot-off-the-press-18fs-api-standards.md",
      "filepathURL" :"https://github.com/GSA/digitalgov.gov/blob/bc-archive-content-3/content/news/2014/07/2014-07-16-hot-off-the-press-18fs-api-standards.md",
      "editpathURL" :"https://github.com/GSA/digitalgov.gov/edit/bc-archive-content-3/content/news/2014/07/2014-07-16-hot-off-the-press-18fs-api-standards.md","slug" : "hot-off-the-press-18fs-api-standards","url" : "/preview/gsa/digitalgov.gov/bc-archive-content-3/2014/07/16/hot-off-the-press-18fs-api-standards/","content" :"\u003cp\u003e\u003cdiv class=\"image\"\u003e\n  \u003cimg\n    src=\"https://s3.amazonaws.com/digitalgov/_legacy-img/2014/07/250-x-264-18F-blue-light-bulb.jpg\"\n    alt=\"250-x-264-18F-blue-light-bulb\"/\u003e\u003c/div\u003e\n\nWe recently released the first version of our \u003ca href=\"https://github.com/18F/api-standards\"\u003eAPI Standards\u003c/a\u003e—a set of recommendations and guidelines for API production. It is our intention that every 18F API meet these standards, to help us ensure a baseline quality and consistency across all APIs we offer now and in the future.\u003c/p\u003e\n\u003cp\u003eThese standards guide the user-facing implementation details of an API. Wherever possible, the standards prescribe a goal instead of a specific technology. What was once universally recommended about APIs just a few years ago may be dated today. For example, while the best issue tracker may change every couple years, the need for an obvious point of contact to the API producer is more enduring.\u003c/p\u003e\n\u003cp\u003eThe standards are generally technology-neutral, with a few specific opinions when warranted. For example, our standards don’t allow for the use of JSONP, as it raises \u003ca href=\"https://en.wikipedia.org/wiki/JSONP#Security_concerns\"\u003esecurity\u003c/a\u003e and \u003ca href=\"https://gist.github.com/tmcw/6244497#practical-concerns\"\u003eperformance\u003c/a\u003e concerns.\u003c/p\u003e\n\u003cp\u003eThough these standards are part of a living document, a focus on goals—and not on tools—will increase their shelf-life. By writing these standards under a goal-oriented and “sane defaults” approach, we hope they help us achieve API objectives that will never change: utility for the users and respect for their time and effort.\u003c/p\u003e\n\u003cp\u003eWe began drafting our standards after forking the White House’s own API standards. By \u003ca href=\"https://github.com/WhiteHouse/api-standards\"\u003epublishing their standards in the open\u003c/a\u003e so others could benefit, the White House set an important example—one that we greatly support! Similarly, we invite you to fork our API standards and modify as needed for your own organization’s use.\u003cem\u003eThis post was originally published on the \u003ca href=\"https://18f.gsa.gov/\"\u003e18f blog\u003c/a\u003e by Alan DeLevie and Eric Mill of \u003ca href=\"https://18f.gsa.gov/\"\u003e18f\u003c/a\u003e.\u003c/em\u003e\u003c/p\u003e\n"}
  ]
}