Benutzerdefinierte Felder neu ordnen

POST https://app.sendapp.ai/api/contact-fields/reorder

Ändert die Reihenfolge der benutzerdefinierten Felder, dieselbe wie auf der Seite und im Kontaktformular. Die gesendeten IDs kommen zuerst in der angegebenen Reihenfolge; die übrigen Felder folgen in ihrer aktuellen Reihenfolge.

Alle IDs müssen Felder deines Kontos sein: Andernfalls wird die Anfrage mit 422 und der Liste unknown_ids abgelehnt, ohne etwas zu ändern.

Häufige Fehler: 401, wenn der API-Schlüssel fehlt oder falsch ist — 403, wenn der Tarif abgelaufen ist oder keinen API-Zugang enthält — 429, wenn du in kurzer Zeit zu viele Anfragen sendest oder gerade eine andere Änderung an den benutzerdefinierten Feldern deines Kontos läuft: versuche es nach ein paar Sekunden erneut.

Parameter

2 · 2 Pflichtfelder

apikey erforderlich

Ihr API Key (der Header X-API-Key funktioniert ebenfalls).

order erforderlich

Array von Feld-IDs, z. B. [12, 7, 9].

Brauchen Sie Hilfe bei der Integration? info@sendapp.live

Anfrage

curl -X POST 'https://app.sendapp.ai/api/contact-fields/reorder' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ "order": [13, 12] }'

<?php
$ch = curl_init('https://app.sendapp.ai/api/contact-fields/reorder');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['X-API-Key: YOUR_API_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode(['order' => [13, 12]]),
]);
echo curl_exec($ch);
curl_close($ch);

const res = await fetch('https://app.sendapp.ai/api/contact-fields/reorder', {
  method: 'POST',
  headers: { 'X-API-Key': 'YOUR_API_KEY', 'Content-Type': 'application/json' },
  body: JSON.stringify({ order: [13, 12] })
});
console.log(await res.json());

Antwort

{
  "status": "success",
  "message": "Fields reordered.",
  "fields": [
    { "id": 13, "name": "Size", "sort_order": 0, "...": "..." },
    { "id": 12, "name": "City", "sort_order": 1, "...": "..." }
  ]
}

{
  "status": "error",
  "message": "Unknown field id(s): 99. Use GET /api/contact-fields to list your fields.",
  "unknown_ids": [99]
}