Enviando JSON

A maioria das APIs hoje espera JSON, não codificação de formulário. Duas coisas precisam mudar, e esquecer a segunda é o erro mais comum em toda essa área.

curl -s -H 'Content-Type: application/json' \
     -d '{"name":"ada"}' http://127.0.0.1:9125/users

Primeiro, o corpo se torna JSON. Segundo, você precisa declará-lo com um cabeçalho Content-Type, porque, caso contrário, o curl ainda identifica o corpo como dados de formulário. O servidor então tenta analisar o JSON como pares key=value e o rejeita, geralmente com um 400.

Portanto, quando uma API disser que seu JSON é inválido e ele parecer perfeitamente válido para você, verifique o cabeçalho antes de verificar o JSON.

Preste atenção também às aspas. JSON contém muitas aspas duplas, então envolva todo o corpo em aspas simples, e o shell o deixará como está.