Lista todas as Skills da conta atual com paginação baseada em cursor.
Cabeçalhos da requisição
|
Cabeçalho |
Obrigatório |
Descrição |
|
Authorization |
Sim |
Bearer PAT — consulte Authorization: Bearer $QODER_PAT. |
Parâmetros de consulta
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
|
limit |
integer |
Não |
Número máximo de itens retornados por página. |
|
after |
string |
Não |
Cursor de paginação. Retorna registros posteriores ao ID informado. |
Consulte Paginação para obter o contrato completo de paginação.
Exemplo de requisição
# List all Skills
curl -X GET "https://api.qoder.com.cn/api/v1/cloud/skills" \
-H "Authorization: Bearer $QODER_PAT"
# Paginate with a page size
curl -X GET "https://api.qoder.com.cn/api/v1/cloud/skills?limit=10" \
-H "Authorization: Bearer $QODER_PAT"
# Fetch the next page with a cursor
curl -X GET "https://api.qoder.com.cn/api/v1/cloud/skills?limit=10&after=skill_019e3bba474b73cfaf19eae9b5f5e66d" \
-H "Authorization: Bearer $QODER_PAT"
Exemplo de resposta
HTTP 200 OK
{
"data": [
{
"id": "skill_019e3bba474b73cfaf19eae9b5f5e66d",
"type": "skill",
"name": "test-skill-api-doc",
"description": "A test Skill for API documentation",
"skill_type": "custom",
"status": "active",
"version": 1,
"content_size": 309,
"content_sha256": "f253cb7d35790025f85917c0c239422cff1de067d00278db8897c585a3f28d94",
"metadata": {},
"created_at": "2026-05-18T15:35:24.248164Z",
"updated_at": "2026-05-18T15:35:24.248164Z"
}
],
"first_id": "skill_019e3bba474b73cfaf19eae9b5f5e66d",
"last_id": "skill_019e3bba474b73cfaf19eae9b5f5e66d",
"has_more": false
}
Resposta com lista vazia:
{
"data": [],
"first_id": null,
"last_id": null,
"has_more": false
}
Campos da resposta
|
Campo |
Tipo |
Descrição |
|
|
data |
array |
Array de objetos Skill. |
|
|
first_id |
string \ |
null |
ID da primeira Skill na página. Valor |
|
last_id |
string \ |
null |
ID da última Skill na página. Valor |
|
has_more |
boolean |
Indica se há mais itens disponíveis. Use last_id como parâmetro after na próxima requisição. |
Erros
|
HTTP |
Tipo |
Causa |
|
401 |
authentication_error |
Token de autenticação ausente ou inválido. |
Para consultar o envelope completo de erros, veja Erros.