Benutzerdefinierte Objekt-API (/custom_objects/id)
Verwenden Sie die API für benutzerdefinierte Objekte, um neue Datensätze für Ihre benutzerdefinierten Objekte zu erstellen.
Einleitung
Verwenden Sie die API für benutzerdefinierte Objekte, um die Datensätze für Ihre benutzerdefinierten Objekte zu erstellen, zu aktualisieren oder abzufragen. Wenn Sie ein neues benutzerdefiniertes Objekt definieren müssen, verwenden Sie die Benutzeroberfläche.
Die URL für den Zugriff auf die API für benutzerdefinierte Objekte lautet: https:/<instance>//api/custom_objects/{object_id}
Weitere Informationen finden Sie unter Integrations-Best Practices.
Aktionen
| Verb | Pfad | Aktion | Beschreibung |
|---|---|---|---|
| BEITRAG | /api/custom_objects/{object_id}/object_instances/ |
erstellen | Erstellen Sie einen neuen Datensatz für das benutzerdefinierte Objekt |
| PUT | /api/custom_objects/{object_id}/object_instances/{instance_id} |
aktualisieren | Einen vorhandenen Datensatz ändern |
| ABFRAGEN | /api/custom_objects/{object_id}/object_instances/ |
index | Listet alle Datensätze für das benutzerdefinierte Objekt auf |
| ABFRAGEN | /api/custom_objects/{object_id}/object_instances/{instance_id} |
anzeigen | Listet einen einzelnen Datensatz auf |
Elemente (Objektinstanz)
| Element | Beschreibung | Anf. | Eindeutig | Zulässiger Wert | In | Out | Datentyp |
|---|---|---|---|---|---|---|---|
| created-at | Automatisch von Coupa erstellt im Format JJJJ-MM-TTTHH:MM:SS+HH:MMZ | alle | ja | datum/Uhrzeit | |||
| erstellt von | Benutzer der Erstellung | alle | ja | Benutzer | |||
| benutzerdefinierter-Objekt-Code | Kundenspezifischer Objektcode | alle | ja | zeichenfolge | |||
| benutzerdefinierter-Objekt-Name | Benutzerdefinierter Objektname | alle | ja | zeichenfolge | |||
| form-response-id | ID der Formularantwort, die die Instanz erstellt hat | alle | ja | ganze Zahl | |||
| iD | Interne Coupa-ID | alle | ja | ganze Zahl | |||
| updated-at | Automatisch von Coupa erstellt im Format JJJJ-MM-TTTHH:MM:SS+HH:MMZ | alle | ja | datum/Uhrzeit | |||
| aktualisiert von | Benutzer der Aktualisierung | alle | ja | Benutzer |
Elemente werden NUR FÜR GET-ANRUFE verwendet. POST- oder PUT-ANRUFE enthalten nur die benutzerdefinierten Felder, die in Ihrer benutzerdefinierten Objektdefinition verwendet werden. Siehe das folgende Beispiel für Details.
Beispiel-Nutzlasten
Da ein benutzerdefiniertes Objekt vollständig aus benutzerdefinierten Feldern besteht, müssen Sie Ihre benutzerdefinierten Felder im Namensraum des benutzerdefinierten Felds enthalten. Ein einfacher POST oder PUT sollte diese Form haben:
<object-instance>
<custom-fields>
<custom-field-1>benutzerdefiniertes-feld-1-wert</custom-field-1>
<custom-field-2>custom-field-2-value</custom-field-2>
...
<custom-field-10>benutzerdefiniertes-feld-10-wert</custom-field-10>
<custom-fields>
</object-instance>