공개 API
토큰 하나로 링크와 자산을 읽고 쓰고 설치합니다.
Pado의 공개 API는 개인 토큰으로 인증합니다. 토큰은 내 활동 화면에서 발급하고, Authorization: Bearer <토큰> 헤더나 ?token= 질의로 보냅니다.
조회
GET https://pado.bcdflow.net/api/public/search?kind=link&search=클로드&limit=20
| 이름 | 설명 |
|---|---|
| kind | link 또는 asset (기본 link) |
| search | 제목, 요약, 도메인에서 찾습니다 |
| category | 분류 slug |
| includeTags | 포함할 태그, 쉼표로 구분 |
| excludeTags | 제외할 태그, 쉼표로 구분 |
| sort | latest 또는 popular |
| page, limit | 기본 1, 20 (최대 100) |
자산 조회 결과에는 downloadScript 가 함께 옵니다. 그대로 실행하면 현재 폴더에 설치됩니다.
링크 밀어 넣기
POST https://pado.bcdflow.net/api/ingest/links
Content-Type: application/json
Authorization: Bearer <토큰>
{
"items": [
{
"url": "https://example.com/article",
"message": "이거 정리 잘 돼 있어요",
"room": "개발자 수다방",
"nickname": "지훈",
"externalId": "kakao-log-id",
"at": "2026-08-23T10:12:00Z"
}
]
}
url 을 생략하면 message 안에서 주소를 찾아냅니다. 건마다 분류와 유용도 점수를 매기고, 점수가 낮으면 등록하지 않습니다. 강제로 올리려면 "force": true 를 붙입니다.
응답:
{ "ok": true, "created": 1, "duplicate": 0, "rejected": 0,
"items": [{ "url": "...", "result": "created", "category": "dev", "score": 78, "tags": ["tutorial"] }] }
자산 올리기
POST https://pado.bcdflow.net/api/registry
{
"title": "릴리스 노트 정리 스킬",
"category": "skills",
"summary": "커밋 목록을 사람이 읽을 수 있는 노트로 바꿉니다",
"folderName": ".claude",
"tags": ["claude-code", "automation"],
"files": {
"skills/release-notes/SKILL.md": { "content": "---\nname: release-notes\n---\n" }
}
}
파일은 60개, 개당 1MB, 전체 8MB까지 받습니다. 바이너리는 "binary": true 와 함께 base64로 보냅니다.
새 버전 발행
POST https://pado.bcdflow.net/api/registry/{slug}/versions
{ "releaseType": "minor", "releaseNotes": "설치 스크립트 추가" }
files 를 생략하면 직전 버전의 파일을 그대로 승계합니다.
오류
| 상태 | 뜻 |
|---|---|
| 400 | 요청이 잘못됨 |
| 401 | 토큰이 유효하지 않음 |
| 403 | 본인 자산이 아님 |
| 404 | 대상 없음 |
| 409 | 이미 있는 버전 |