Serverlose Funktionen – Eingabearten
Inhaltsverzeichnis
Die Funktion kann auf folgende Weise eingegeben werden:
Parameter
Parameter werden in der URL der Abfragezeichenfolge und die Daten im Abschnitt "Formulardaten" in eine Eingabe übergeben. Die Parameter in der Zuweisung "crmAPIRequest" enthalten diese Parameter, die alle Informationen haben, die in der Anfrage übergeben werden.
Senden von Parametern mit POSTMAN innerhalb der Anforderungs-URL:
Senden von Parametern mit POSTMAN als JSON-Objekte in Formulardaten:
Parameter mit POSTMAN als Schlüssel in Formulardaten senden:
Alle Parameter, die die in der Funktion definierten Argumente zuweisen, werden automatisch synchronisiert.
So erhalten Sie zusätzliche Parameter, die in der Anfrage verwendet werden:
crmAPIRequestMap = crmAPIRequest.toMap();
// zum Abruf der Parameter der Anfrage
Parameter = crmAPIRequestMap.get("params");
/**
Ihre Geschäftslogik hier
**/
gibt crmAPIRequestMap zurück;
Hinweis:
- Vermeiden Sie den Namen "arguments" als Argument innerhalb der Funktion. Die Namensinkongruenz kann dazu führen, dass einige Argumente nicht funktionieren.
- Die Zuweisung der Argumente der Funktion erfolgt automatisch bei der Übergabe durch "Parameter", d. h. Durchlauf durch Abfragezeichenfolge (der URL) oder die Formulardaten.
Stream
Der "Text" der Anfrage kann verwendet werden, um den Inhalt, der als Stream an die Anfrage übergeben wird, zu erhalten. Normalerweise wird der Text nur verwendet, wenn die Anforderungsmethode POST ist.
Senden von Text mit POSTMAN als Stream (raw):
Senden von Text mit POSTMAN als Binärdatei:
So erhalten Sie den gesamten Textabschnitt der Anforderung in einer Funktion:
crmAPIRequestMap = crmAPIRequest.toMap();
// um den Textinhalt der Anfrage zu erhalten
request_body = crmAPIRequestMap.get("body");
/**
Ihre Geschäftslogik hier
**/
gibt crmAPIRequestMap zurück;
In POSTMAN kann der Textinhalt entweder im Roh- oder Binärformat übergeben werden.
Hinweis:
- Wenn Argumente der Funktion durch Stream übergeben werden, werden sie nicht den Argumenten der Funktion zugewiesen.
- Falls Sie die Eingabedaten innerhalb der Funktion kodieren/dekodieren müssen, können Sie die in Deluge verfügbaren Verschlüsselungsaufgaben verwenden.
Dateiinhalt
Wenn der Inhaltstyp der Anforderung "Mehrteilig" ist, wird sie als Datei betrachtet. Sie können die Datei innerhalb der Funktion im Anfrageobjekt abrufen.
Die derzeit unterstützten Dateitypen sind Textdateien. Um die Datei als mehrteilige Daten an die Funktion zu senden, senden Sie sie unter dem Argumentnamen "inputFile".
So laden Sie die Datei zur Verwendung in der Funktion hoch:
crmAPIRequestMap = crmAPIRequest.toMap();
// um den Dateiinhalt der Anfrage zu erhalten
parameter = crmAPIRequestMap.get("file_content");
/**
Ihre Geschäftslogik hier
**/
gibt crmAPIRequestMap zurück;
Hinweis:
- Wenn die Eingabe für die Funktion als "Datei" erfolgt, werden die Argumente in der Datei nicht den Argumenten der Funktion zugewiesen.
Überschriften
Die Überschrift einer Anfrage enthält in der Regel zusätzliche Informationen über die Anfrage. Die darin verfügbaren Informationen können im Schlüssel "headers" innerhalb des "crmAPIRequest"-Arguments erfasst werden.
So erhalten Sie die Überschriften der Anfrage:
crmAPIRequestMap = crmAPIRequest.toMap();
// um die Benutzerinformationen der Anfrage zu erhalten
header_request = crmAPIRequestMap.get("headers");
/**
Ihre Geschäftslogik hier
**/
gibt crmAPIRequestMap zurück;
Benutzerinformationen
Dieser Schlüssel kann verwendet werden, um die Informationen über den Benutzer sowie das Unternehmen des Benutzers zu erhalten, der die Funktion mit der OAuth2-Methode aufruft.
So erhalten Sie die Informationen über die Benutzer:
crmAPIRequestMap = crmAPIRequest.toMap();
// um die Benutzerinformationen der Anfrage zu erhalten
user_info = crmAPIRequestMap.get("user_info");
/**
Ihre Geschäftslogik hier
**/
gibt crmAPIRequestMap zurück;
Hinweis:
- Wenn die Funktion als API-Schlüssel aufgerufen wird, wäre die Benutzerinformation, die Sie erhalten, die Information des Superadministrators und nicht desjenigen, der die Funktion aufruft.
Authentifizierungstyp und -methode
Diese beiden Schlüssel können verwendet werden, um die Authentifizierungsinformationen ("apikey" oder "oauth") und die HTTP-Methode (GET/POST) abzurufen.
So erhalten Sie die Informationen über den Authentifizierungstyp:
crmAPIRequestMap = crmAPIRequest.toMap();
// um die HTTP-Methode der Anfrage zu erhalten
user_info = crmAPIRequestMap.get("method");
// um den Authentifizierungstyp der Anfrage abzurufen
user_info = crmAPIRequestMap.get("auth_type");
/**
Ihre Geschäftslogik hier
**/
gibt crmAPIRequestMap zurück;