Interroger la liste des Skills

Permet d'interroger la liste des Skills au sein de l'organisation spécifiée.

Cette interface permet d'interroger la liste des Skills au sein de l'organisation spécifiée.

Méthode de requête

GET

URL de la requête

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

Authentification de la requête

Utilise l'authentification Basic avec la DevKey / le DevSecret de niveau compte.

Requête

Exemple de requête

curl -X GET 'https://api.${endpoint}/v1/org/skill/list?org_id=p-xxxx&keyword=refund&owner_type=ORGANIZATION&enable=true' \ -H 'Authorization: Basic ${BASIC_TOKEN}'

                      
                      curl -X GET 'https://api.${endpoint}/v1/org/skill/list?org_id=p-xxxx&keyword=refund&owner_type=ORGANIZATION&enable=true' \
  -H 'Authorization: Basic ${BASIC_TOKEN}'

Ce bloc de code dans la fenêtre flottante

En-têtes de la requête

Champ	Type	Description
Authorization	Basic ${BASIC_TOKEN}	Utilisez le Basic Token obtenu en encodant `DevKey:DevSecret` en Base64.
Locale	String	Facultatif. Langue du texte de réponse, `en_US` par défaut.

Paramètres de la requête (Query Parameters)

Champ	Type	Description	required
org_id	String	ID de l'organisation.	true
keyword	String	Mot-clé.	false
category_id	String	ID de catégorie du Skill.	false
owner_type	String	Type d'appartenance du Skill, par exemple `ORGANIZATION`.	false
owner_agent_id	String	ID de l'Agent auquel appartient le Skill privé.	false
enable	Boolean	Indique s'il faut ne renvoyer que les Skills activés ou désactivés.	false

Réponse

Exemple de réponse

{ "code": 0, "message": "OK", "data": [ { "id": "skill-xxxx", "name": "refund-policy", "display_name": "退款政策", "owner_type": "ORGANIZATION", "enable": true } ] }

                      
                      {
  "code": 0,
  "message": "OK",
  "data": [
    {
      "id": "skill-xxxx",
      "name": "refund-policy",
      "display_name": "退款政策",
      "owner_type": "ORGANIZATION",
      "enable": true
    }
  ]
}

Ce bloc de code dans la fenêtre flottante

Réponse en cas de succès

Les éléments de réponse réutilisent les champs de la liste Skill de la console et comprennent l'ID du Skill, le nom, la description, le propriétaire, la catégorie, la version, l'état d'activation, etc.

Réponse en cas d'échec

Champ	Type	Description
code	Integer	Code d'erreur.
message	String	Détails de l'erreur.

Codes d'état

Code d'état	Description
200	Succès
400	Erreur de paramètre
401	Non autorisé
403	Autorisation insuffisante
429	Requêtes trop fréquentes
500	Erreur du serveur