Consultar lista de Skill

Permite consultar la lista de Skill de una organización específica.

Mediante esta interfaz, se puede consultar la lista de Skill de una organización específica.

Método de solicitud

GET

URL de la solicitud

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

Autenticación de la solicitud

Utiliza la autenticación Basic con DevKey / DevSecret a nivel de cuenta.

Solicitud

Ejemplo de solicitud

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}'

Este bloque de código en una ventana flotante

Cabeceras de la solicitud

Campo	Tipo	Descripción
Authorization	Basic ${BASIC_TOKEN}	Basic Token resultante de codificar `DevKey:DevSecret` en Base64.
Locale	String	Opcional. Idioma del texto de la respuesta; el valor predeterminado es `en_US`.

Parámetros de la solicitud (Query Parameters)

Campo	Tipo	Descripción	Obligatorio
org_id	String	ID de la organización.	true
keyword	String	Palabra clave.	false
category_id	String	ID de la categoría del Skill.	false
owner_type	String	Tipo de propietario del Skill, como `ORGANIZATION`.	false
owner_agent_id	String	ID del Agent al que pertenece el Skill privado.	false
enable	Boolean	Indica si solo se devuelven los Skill habilitados o deshabilitados.	false

Respuesta

Ejemplo de respuesta

{ "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
    }
  ]
}

Este bloque de código en una ventana flotante

Respuesta correcta

Los elementos de la respuesta reutilizan los campos de la lista de Skill de la consola, e incluyen información como el ID del Skill, el nombre, la descripción, el propietario, la categoría, la versión y el estado de habilitación.

Respuesta fallida

Campo	Tipo	Descripción
code	Integer	Código de error.
message	String	Detalles del error.

Códigos de estado

Código de estado	Descripción
200	Correcto
400	Error de parámetros
401	No autorizado
403	Permisos insuficientes
429	Demasiadas solicitudes
500	Error del servidor