Part 2

Part 2

1. End Points

   • Fetch a random dad joke
     • Connect to the database
       • Database send joke
         • server receives joke
           • Display programmatically transformed joke
   • Fetch a dad joke
     • Connect to the database
       • Database sends random joke from list to server
         • Server receives random joke
           • Display programmatically transformed joke
   • Fetch a dad joke as a slack message
     • Can be used by third parties who need to receive a random joke formatted as a slack message
       • Only returns JSON
   • Fetch a dad joke as an image
     • Server connects to the database
       • Database sends joke to server
         • Transform joke from text to image
           • Display joke image
   • Search for dad jokes
     • User searches for joke
     • Number of results to return per page is limited
     • Term: search term to use (Default: list all jokes)
     • Display page results (e.g 1-20)

2. Calling the API

   • API response format
     • Text/HTML
       • HTML response (Default response format).
     • Text/plain
       • Plain text response
     • Application/JSON
       • JSON response
     • Custom user agent
   • Authentication
     • There is no authentication required for the icanhazdadjoke API
   • Custom user agent
     • User agent
       • Includes;
         • Name of the library
         • URL/e-email
           • Allows someone to be contacted through the library/website
             • e.g: curl -H "User-Agent: My library (https://github.com/username/repo)" https://icanhazdadjoke.com/
       • Definition: Is a request that allows a characteristic string to enable network protocol peers to identify the operating system and browser of the web-server.