API Terms to Know - abbernie/web-dev-sp17 GitHub Wiki
API - A way for computers to send data to each other. A way for you, as a programmer, to access data from services you want to use in your website, like Twitter, Tumblr, or YouTube. Technically, it stands for Application Programming Interface, which basically means that a service, or Application can set up standards for interacting, or Interfacing with its information. The APIs we'll be using will all specify a URL to use that will allow us to retrieve the information we need. For a succinct, 3-minute explanation of APIs, see this YouTube video.
URI (aka URL) - The web address you go to to access an API
Example: http://api.tumblr.com/v2/blog/applemusic.tumblr.com/posts?api_key=n0xydjN5o4gRL
API Key - a long series of letters and numbers that a service gives you to identify yourself when you use their API.
For example, It might look something like this: 9FclwlYIt0RLk9yicQzFMiNkzLjhrdLn2PkWIPw5x51a
API end-point - The part of a URL that determines what type of information the API will provide
Example: In this URL, https://api.tumblr.com/v2/tagged?tag=kittens&api_key=22fuiKNFp9
, the end point is "tagged"
Query String - The ending part of some URLs, it begins with a question mark, and can contain one or more name-value pairs, each separated by and ampersand (&).
For example, in the URL https://api.tumblr.com/v2/tagged?tag=kittens&api_key=22fuiKNFp9
, the query string is:
?tag=kittens&api_key=22fuiKNFp9
. In this case, the query string contains two name-value pairs; they are:
- tag=kittens
- api_key=22fuiKNFp9
API Documentation - The user manual for a particular API.
For example, Tumblr's API Documentation is here: https://www.tumblr.com/docs/en/api/v2
Parse - To analyze; to study something by looking at its parts closely. -Merriam Webster Dictionary
JSON - A way of formatting text that's easy for computers to process. JSON stands for JavaScript Object Notation -- its formatting is almost identical to the way objects are formatted in Javascript.