Trabalhando com API em Swift: REST, GraphQL, gRPC – o que escolher em 2025?

API em Swift: da teoria às requisições reais

Todo desenvolvedor iOS, mais cedo ou mais tarde, enfrenta a necessidade de comunicação do aplicativo com o servidor. Seja para carregar um feed de notícias, enviar dados de formulário ou fazer streaming em tempo real — não há como evitar uma API (Application Programming Interface). Mas qual protocolo escolher? O clássico REST, o flexível GraphQL ou o ultrarrápido gRPC?

Neste artigo, não vamos apenas listar prós e contras. Vamos analisar o trabalho com API em Swift com exemplos reais, mostrar código e dar dicas práticas. Você aprenderá como estruturar corretamente a camada de rede, quais bibliotecas usar e quando cada abordagem se torna a melhor escolha.

Se você programa em Swift e quer que seu aplicativo se comunique com o backend de forma rápida, confiável e elegante — este artigo é para você. Vamos lá!

REST API em Swift: o clássico que nunca envelhece

REST (Representational State Transfer) é um estilo arquitetural que utiliza métodos HTTP (GET, POST, PUT, DELETE) para trabalhar com recursos. A maioria das APIs públicas (GitHub, Twitter, Stripe) são construídas sobre REST. Para o desenvolvedor Swift, isso significa trabalhar com JSON, URLSession ou Alamofire.

Requisição GET básica com URLSession

Vamos começar com o mais simples — obter dados. Imagine que precisamos carregar uma lista de usuários do JSONPlaceholder:

import Foundation\n\nstruct User: Codable {\n    let id: Int\n    let name: String\n    let email: String\n}\n\nfunc fetchUsers() async throws -> [User] {\n    let url = URL(string: "https://jsonplaceholder.typicode.com/users")!\n    let (data, response) = try await URLSession.shared.data(from: url)\n    \n    guard let httpResponse = response as? HTTPURLResponse,\n          (200...299).contains(httpResponse.statusCode) else {\n        throw URLError(.badServerResponse)\n    }\n    \n    return try JSONDecoder().decode([User].self, from: data)\n}\n\nTask {\n    do {\n        let users = try await fetchUsers()\n        print("Carregados \\(users.count) usuários")\n    } catch {\n        print("Erro: \\(error.localizedDescription)")\n    }\n}

Observe o uso de async/await — esta é a forma moderna de trabalhar com código assíncrono em Swift. O código ficou legível e conciso, sem closures e callbacks.

Requisição POST com Alamofire

Alamofire é a biblioteca mais popular para trabalho de rede em Swift. Ela simplifica o tratamento de erros, a codificação de parâmetros e o upload de arquivos. Aqui está um exemplo de envio de dados:

import Alamofire\n\nstruct NewUser: Encodable {\n    let name: String\n    let email: String\n}\n\nAF.request("https://jsonplaceholder.typicode.com/users",\n           method: .post,\n           parameters: NewUser(name: "João", email: "joao@example.com"),\n           encoder: JSONParameterEncoder.default)\n    .validate()\n    .responseDecodable(of: User.self) { response in\n        switch response.result {\n        case .success(let user):\n            print("Usuário criado com id: \\(user.id)")\n        case .failure(let error):\n            print("Erro: \\(error.localizedDescription)")\n        }\n    }

Dica: Use .validate() — isso verificará automaticamente o código de status e converterá erros HTTP em erros do Alamofire. Seu código ficará mais limpo e a depuração, mais fácil.

Quando o REST é a melhor escolha?

\n
• Você tem um aplicativo CRUD simples (anotações, lista de tarefas).
\n
• A API fornece endpoints fixos.
\n
• Você não precisa de aninhamento complexo de dados.
\n

GraphQL em Swift: flexibilidade nas consultas

GraphQL é uma linguagem de consulta que permite ao cliente solicitar exatamente os dados de que precisa. Sem over-fetching (campos extras) ou under-fetching (várias requisições necessárias). Para Swift, existe a excelente biblioteca Apollo iOS

Blogs

Trabalhando com JSON em Java: parsing e serialização para iniciantes

Book Recommendations

Java e bancos de dados: guia prático

Rust e microsserviços: da ideia à produção

Programação Funcional em Java

Let's Go

Leia também

TypeScript Generics: escrevendo código flexível sem duplicação Dominando o sistema de arquivos: trabalhando com arquivos em JavaScript Padrões de Projeto em TypeScript: nível avançado com exemplos Guia completo para verificar substring em Swift com exemplos de código Como um programa Rust lê seus metadados do Cargo.toml