# Getting started with cURL

# What is cURL?

**cURL (short for “Client URL”) is a command-line tool that lets you send requests to servers from your terminal and see their responses. It’s like using your terminal to “talk” to websites or APIs instead of a browser.**

# Why programmers need cURL

* Quick connectivity checks: “Is this server/API reachable?”
    
* Inspecting responses: See raw HTML, JSON, or error messages to debug.
    
* Fast iteration: Test endpoints without writing code or opening a browser.
    

# Making your first request using cURL

* Reminder: A server is a computer on the internet that listens for requests and sends back responses (web pages, API data, files).
    
* Simplest GET request (fetch a web page):
    
    * curl [https://example.com](https://example.com/)
        
    * This sends a GET request and prints the response body (e.g., the HTML) in your terminal.
        
* Tip: Start with just curl URL to build confidence. Add options later.
    

# Understanding request and response

* Request: Method (GET or POST), URL, optional headers/body.
    
* Response parts:
    
    * Status code (200 OK, 404 Not Found, 500 Server Error, etc.).
        
    * Headers (metadata like Content-Type: application/json).
        
    * Body (the actual content: HTML, JSON, text, etc.).
        
* By default, curl shows you the body. To see headers too, add -i (later, once you’re comfortable).
    

# Using cURL to talk to APIs

* GET (fetch data):
    
    * curl [https://api.example.com/users](https://api.example.com/users)
        
    * Typically returns JSON.
        
* POST (send data):
    
    * curl -X POST -d "name=Alex&role=admin" [https://api.example.com/users](https://api.example.com/users)
        
    * \-X POST sets the method; -d adds form data to the request body.
        
* For JSON APIs, a minimal example (when ready to add a header):
    
    * curl -X POST -H "Content-Type: application/json" -d '{"name":"Alex","role":"admin"}' [https://api.example.com/users](https://api.example.com/users)
        
* Start with simple GET; add POST and minimal headers when needed.
    

# Common mistakes beginners make with cURL

* Using the wrong URL (missing https:// or the wrong endpoint).
    
* Forgetting data with POST (no -d) or forgetting to set the method (-X POST).
    
* Expecting JSON but hitting an HTML page (wrong endpoint or URL).
    
* Adding too many flags too soon; stick to curl URL first, then layer options gradually.