Skill per Datei importieren und erstellen

Ermöglicht das Hochladen eines Skill-Installationspakets und dessen Import als Organisations-Skill.

Über diese Schnittstelle können Sie ein .zip- oder .skill-Skill-Installationspaket hochladen und als Organisations-Skill importieren.

Anfragemethode

POST

Anfrage-URL

https://api.${endpoint}/v1/org/skill/import

Authentifizierung der Anfrage

Basic-Authentifizierung mit DevKey / DevSecret auf Kontoebene; das aufrufende Konto muss über die Berechtigung zum Erstellen von Skill der Organisation verfügen.

Anfrage

Beispielanfrage

curl -X POST 'https://api.${endpoint}/v1/org/skill/import' \ -H 'Authorization: Basic ${BASIC_TOKEN}' \ -F 'file=@/path/to/refund-policy.skill' \ -F 'org_id=p-xxxx' \ -F 'category_id=cat-xxxx'

                      
                      curl -X POST 'https://api.${endpoint}/v1/org/skill/import' \
  -H 'Authorization: Basic ${BASIC_TOKEN}' \
  -F 'file=@/path/to/refund-policy.skill' \
  -F 'org_id=p-xxxx' \
  -F 'category_id=cat-xxxx'

Dieser Codeblock im schwebenden Fenster

Anfrage-Header

Feld	Typ	Beschreibung
Authorization	Basic ${BASIC_TOKEN}	Basic Token als Base64-Kodierung von `DevKey:DevSecret`.
Content-Type	multipart/form-data	Formular für den Datei-Upload.

Anfrageparameter (Form Data)

Parameter	Typ	Beschreibung	required
file	File	`.zip`- oder `.skill`-Skill-Installationspaket.	true
org_id	String	Organisations-ID.	true
category_id	String	ID der Skill-Kategorie.	false

Antwort

Beispielantwort

{ "code": 0, "message": "OK", "data": { "skill_id": "skill-xxxx", "name": "refund-policy", "owner_type": "ORGANIZATION" } }

                      
                      {
  "code": 0,
  "message": "OK",
  "data": {
    "skill_id": "skill-xxxx",
    "name": "refund-policy",
    "owner_type": "ORGANIZATION"
  }
}

Dieser Codeblock im schwebenden Fenster

Erfolgreiche Antwort

Feld	Typ	Beschreibung
skill_id	String	ID des importierten Skill.
name	String	Skill-Name.
owner_type	String	Zugehörigkeitstyp des Skill.

Fehlerantwort

Feld	Typ	Beschreibung
code	Integer	Fehlercode.
message	String	Fehlerdetails.

Statuscodes

Statuscode	Beschreibung
200	Erfolgreich
400	Ungültige Parameter
401	Nicht autorisiert
403	Unzureichende Berechtigungen
429	Zu viele Anfragen
500	Serverfehler