Upgrade to Pro — share decks privately, control downloads, hide ads and more …

Beta Like You Mean It

Beta Like You Mean It

A lightning talk exploring how and why GitHub ships a public preview for its new APIs.

Presented at REST Fest 2013.

Video: https://vimeo.com/75106817

Jason Rudolph

September 21, 2013
Tweet

Other Decks in Programming

Transcript

  1.  $ curl https://api.github.com/search/code?q=bacon Be Explicit { "message": "If you

    would like to help us test the Search API during its preview period, you must specify a custom media type in the 'Accept' header. Please see the docs for full details.", "documentation_url": "http://developer.github.com/v3/search#preview-mode" } => HTTP/1.1 415 Unsupported Media Type
  2.  $ curl https://api.github.com/search/code?q=bacon Be Explicit { "message": "If you

    would like to help us test the Search API during its preview period, you must specify a custom media type in the 'Accept' header. Please see the docs for full details.", "documentation_url": "http://developer.github.com/v3/search#preview-mode" } { "message": "If you would like to help us test the Search API during its preview period, you must specify a custom media type in the 'Accept' header. Please see the docs for full details.", "documentation_url": "http://developer.github.com/v3/search#preview-mode" } => HTTP/1.1 415 Unsupported Media Type
  3.  { "message": "If you would like to help us

    test the Search API during its preview period, you must specify a custom media type in the 'Accept' header. Please see the docs for full details.", "documentation_url": "http://developer.github.com/v3/search#preview-mode" } $ curl https://api.github.com/search/code?q=bacon Be Explicit { "message": "If you would like to help us test the Search API during its preview period, you must specify a custom media type in the 'Accept' header. Please see the docs for full details.", "documentation_url": "http://developer.github.com/v3/search#preview-mode" } => HTTP/1.1 415 Unsupported Media Type
  4.  { "message": "If you would like to help us

    test the Search API during its preview period, you must specify a custom media type in the 'Accept' header. Please see the docs for full details.", "documentation_url": "http://developer.github.com/v3/search#preview-mode" } { "message": "If you would like to help us test the Search API during its preview period, you must specify a custom media type in the 'Accept' header. Please see the docs for full details.", "documentation_url": "http://developer.github.com/v3/search#preview-mode" } $ curl https://api.github.com/search/code?q=bacon Be Explicit => HTTP/1.1 415 Unsupported Media Type
  5.  { "total_count": 212550, "items": [ ... ] } $

    curl https://api.github.com/search/code?q=bacon -H 'Accept: application/vnd.github.preview+json' “Open Sesame” => HTTP/1.1 200 OK