프로젝트에 등록된 프롬프트를 조회하고 관리합니다.
| Parameter | Type | Description |
|---|---|---|
| q | string | 제목 또는 내용 검색어 |
| tag | string | 태그 필터 |
| category | string | 카테고리 필터 |
| limit | number | 반환할 최대 개수 |
| offset | number | 페이지네이션 오프셋 |
| sort | string | 정렬 필드 (created, updated, title, likes) |
| order | string | 정렬 방향 (asc, desc) |
[
{
"id": 1,
"title": "Marketing Copy Generator",
"content": "Write a copy for {{product}}",
"category": "Marketing",
"tags": "copywriting,marketing",
"versionNumber": 3,
"createdAt": "2024-12-01T10:00:00Z",
"updatedAt": "2024-12-05T15:30:00Z"
}
]특정 버전의 프롬프트를 조회합니다. 프로덕션 환경에서는 고정된 버전을 사용하는 것이 안전합니다.
curl https://promstack.com/api/sdk/prompts/1/version/2 \
-H "Authorization: Bearer $PROMSTACK_API_KEY"프롬프트의 모든 버전 히스토리를 조회합니다.
[
{
"id": 3,
"promptId": 1,
"versionNumber": 3,
"title": "Marketing Copy v3",
"content": "Write a copy for {{product}}.",
"createdAt": "2024-12-05T15:30:00Z",
"createdBy": 1
},
{
"id": 2,
"promptId": 1,
"versionNumber": 2,
"title": "Marketing Copy v2",
"content": "Write {{product}} copy.",
"createdAt": "2024-12-03T10:00:00Z",
"createdBy": 1
}
]// List prompts
const prompts = await client.getPrompts({
category: 'marketing',
tag: 'copywriting',
sort: 'updated',
order: 'desc'
});
// Get specific version
const v2 = await client.getPromptVersion(1, 2);
// Get all versions
const versions = await client.getPromptVersions(1);
// Get categories/tags
const categories = await client.getCategories();
const tags = await client.getTags();
// Search
const result = await client.searchPrompts('marketing', { limit: 10 });
console.log(`Total ${result.total}, returned ${result.prompts.length}`);