03 - CRUD básico

Los recursos siguen el patrón REST estándar.

Operaciones

Operación	Método	URL
Listar	GET	/api/3/clientes
Obtener uno	GET	/api/3/clientes/123
Crear	POST	/api/3/clientes
Actualizar	PUT	/api/3/clientes/123
Eliminar	DELETE	/api/3/clientes/123
Ver esquema	GET	/api/3/clientes/schema

Crear un cliente

El body debe enviarse como formulario: application/x-www-form-urlencoded.

curl -X POST "https://miempresa.beply.es/api/3/clientes" \
  -H "Token: tu-api-key-aquí" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  --data-urlencode "nombre=Cliente de prueba" \
  --data-urlencode "cifnif=B12345678"

Actualizar un registro

curl -X PUT "https://miempresa.beply.es/api/3/clientes/123" \
  -H "Token: tu-api-key-aquí" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  --data-urlencode "nombre=Cliente actualizado"

Descubrir campos con /schema

Usa /schema para saber qué campos existen en una instancia concreta.

curl "https://miempresa.beply.es/api/3/clientes/schema" \
  -H "Token: tu-api-key-aquí"

No asumas que todas las instancias tienen exactamente los mismos campos: los plugins y campos personalizados pueden ampliar los modelos.