Explique o que se entende por API RESTful e como ela funciona.

A API RESTful é um estilo arquitetónico para criar serviços web que utiliza o protocolo HTTP e os princípios REST (Transferência de Estado Representacional). A ideia principal é fornecer recursos (dados) através de URLs únicos, usando métodos HTTP padrão: GET (obter dados), POST (criar), PUT/PATCH (atualizar), DELETE (eliminar).

A API RESTful funciona assim: o cliente envia uma requisição HTTP ao servidor indicando o recurso e o método, o servidor processa a requisição e devolve uma resposta com os dados em formato JSON, XML ou outro. Esta abordagem simplifica a interação entre cliente e servidor, tornando a API fácil de entender e escalável.

Exemplo de uma API RESTful simples em C# usando ASP.NET Core:

[ApiController]
[Route("api/[controller]")]
public class ProductsController : ControllerBase
{
    [HttpGet]
    public IEnumerable<Product> GetAll() => productService.GetAll();

    [HttpGet("{id}")]
    public ActionResult<Product> GetById(int id)
    {
        var product = productService.GetById(id);
        if (product == null) return NotFound();
        return product;
    }

    [HttpPost]
    public IActionResult Create(Product product)
    {
        productService.Add(product);
        return CreatedAtAction(nameof(GetById), new { id = product.Id }, product);
    }
}