PHP API

POST - Criar Dados

• Usado para criar novos recursos
• Dados enviados no body do pedido
• Não é idempotente (múltiplos POSTs criam múltiplos recursos)
• Retorna geralmente o recurso criado com ID

<?php
// POST para criar um novo utilizador
$url = 'https://api.exemplo.com/users';
$data = [
    'name' => 'João Silva',
    'email' => 'joao@exemplo.com'
];

$options = [
    'http' => [
        'header'  => "Content-type: application/json\r\n",
        'method'  => 'POST',
        'content' => json_encode($data)
    ]
];

$context = stream_context_create($options);
$response = file_get_contents($url, false, $context);
?>

PUT - Substituir Dados

• Usado para atualizar/substituir um recurso completo
• Idempotente (múltiplas execuções = mesmo resultado)
• Substitui TODOS os campos do recurso
• Requer todos os campos no body

PATCH - Atualizar Parcialmente

• Usado para atualizar parcialmente um recurso
• Idempotente (depende da implementação)
• Apenas os campos enviados são atualizados
• Os outros campos mantêm-se inalterados

PUT vs PATCH:

• PUT: Substitui todo o recurso
• PATCH: Atualiza apenas os campos enviados

DELETE - Remover Dados

• Usado para remover um recurso
• Idempotente (eliminar o mesmo recurso múltiplas vezes = mesmo resultado)
• Geralmente não tem body
• Pode retornar o recurso eliminado ou status de sucesso

Converter JSON para PHP

<?php
$json = '{"id":1,"nome":"João Silva","email":"joao@exemplo.com"}';

// Para array associativo
$array = json_decode($json, true);
echo $array['nome']; // "João Silva"

// Para objeto stdClass
$objeto = json_decode($json);
echo $objeto->nome; // "João Silva"

// Verificar erros
if (json_last_error() !== JSON_ERROR_NONE) {
    echo "Erro ao decodificar JSON: " . json_last_error_msg();
}
?>