Synupv1
Schlüssel erstellen
v1Ressourcen/Custom Fields/postBenutzerdefinierte Feld-Definition erstellen

Benutzerdefinierte Feld-Definition erstellen

Fügt dem Schema für den angegebenen Entitätstyp ein neues benutzerdefiniertes Feld hinzu. Der key des Feldes wird von seinem label abgeleitet und ist danach unveränderlich; Felder des Typs select benötigen mindestens eine Option.

post/api/v1/custom-fields/definitions
custom-fields:write
Anfragetext
entityTypestring (location | client)erforderlich
Der Entitätstyp, für den dieses Feld gilt: "location" oder "client".
labelstringerforderlich
Das Anzeigelabel des benutzerdefinierten Feldes.
typestring (text | number | date | single_select | multi_select)erforderlich
Der Werttyp des Feldes: text, number, date, single_select oder multi_select.
requiredbooleanoptional
Ob das Feld als erforderlich markiert werden soll. Optional; Standardmäßig false.
optionsarray of stringoptional
Die auswählbaren Optionen des Feldes. Erforderlich (mindestens eine) für Felder des Typs single_select und multi_select; wird für andere Typen ignoriert.
Antwort
dataobjectoptional
definitionobjectoptional
idstringoptional
Eindeutige Kennung der benutzerdefinierten Feld-Definition.
entityTypestring (location | client)optional
Der Entitätstyp, für den diese Definition gilt: "location" oder "client".
keystringoptional
Unveränderlicher Slug, der dieses Feld identifiziert, abgeleitet von seinem label bei der Erstellung. Verwenden Sie dies, um das Feld beim Setzen von Werten zu referenzieren.
labelstringoptional
Das Anzeigelabel des benutzerdefinierten Feldes.
typestring (text | number | date | single_select | multi_select)optional
Der Werttyp des Feldes.
requiredbooleanoptional
Ob das Feld als erforderlich markiert ist. Dies wird von der API nicht erzwungen — es ist nur ein Hinweis für die Benutzeroberfläche.
optionsarray of stringoptional
Die auswählbaren Optionen des Feldes, für Felder des Typs single_select und multi_select. Null für andere Typen.
createdBystringoptional
Wer diese Feld-Definition erstellt hat: "user" oder "agent".
ordernumberoptional
Die Anzeigereihenfolge des Feldes relativ zu anderen Definitionen desselben Entitätstyps, niedrigste zuerst.
Fehler
400Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
401API-Schlüssel fehlt, ist ungültig, abgelaufen oder widerrufen.
403Dem Schlüssel fehlt die erforderliche Berechtigung, oder er ist für diesen Kunden/Standort nicht autorisiert.
422Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
post/api/v1/custom-fields/definitions
Ihr API-Schlüssel
Anfragetext*
{
  "data": {
    "definition": {
      "id": "cm_def_abc123",
      "entityType": "location",
      "key": "parking_notes",
      "label": "Parking notes",
      "type": "text",
      "required": false,
      "options": null,
      "createdBy": "user",
      "order": 0
    }
  }
}