Gegevens kunnen worden verwijderd via de DELETE-methode. Hiervoor specificeer je in de URL het juiste domein en de bijbehorende ID van het object dat je wil verwijderen.


Voorbeeld: DELETE /api/v1/invoices/1001

Verwijdert factuur met ID 1001.


Onderliggende gegevens verwijderen

Wil je een onderliggend object verwijderen (zoals een item of betaling), geef dan ook het relevante subdomein en eventueel de ID daarvan mee in de URL.

  • Geef je wel een ID van het subobject op → dan wordt dat specifieke object verwijderd.

  • Geef je geen ID op → dan worden alle objecten binnen dat subdomein verwijderd.

Voorbeelden:

Verwijder betaling met ID 2893 van factuur 1001: DELETE /api/v1/invoices/1001/payments/2893

Verwijder alle betalingen van factuur 1001: DELETE /api/v1/invoices/1001/payments


Voorbeelden

Verwijder betalingen in curl:

curl -X DELETE "https://eenvoudigfactureren.be/api/v1/invoices/1001/payments" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json"

Verwijder betalingen in JavaScript:

fetch("https://eenvoudigfactureren.be/api/v1/invoices/1001/payments", {
  method: "DELETE",
  headers: {
    "X-API-Key": "your_api_key_here",
    "Content-Type": "application/json",
    "Accept": "application/json"
  }
})
.then(async response => {
  const contentType = response.headers.get("Content-Type");
  const data = contentType && contentType.includes("application/json")
    ? await response.json()
    : await response.text();

  if (!response.ok) {
    throw new Error(data.error || data || `HTTP ${response.status}`);
  }

  console.log("Deleted successfully:", data);
})
.catch(error => {
  console.error("Error:", error.message);
});

Verwijder betalingen in PHP:

$p = curl_init('https://eenvoudigfactureren.be/api/v1/invoices/1001/payments');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "X-API-Key: your_api_key_here",
    "Content-Type: application/json",
    "Accept: application/json"
]);
curl_setopt($p, CURLOPT_CUSTOMREQUEST, "DELETE");
curl_setopt($p, CURLOPT_RETURNTRANSFER, true);
$result = json_decode(curl_exec($p));
curl_close($p);
  Meer info over de API? Lees onderstaande nuttige artikels