pado

공개 API

토큰 하나로 링크와 자산을 읽고 쓰고 설치합니다.

Pado의 공개 API는 개인 토큰으로 인증합니다. 토큰은 내 활동 화면에서 발급하고, Authorization: Bearer <토큰> 헤더나 ?token= 질의로 보냅니다.

조회

GET https://pado.bcdflow.net/api/public/search?kind=link&search=클로드&limit=20
이름설명
kindlink 또는 asset (기본 link)
search제목, 요약, 도메인에서 찾습니다
category분류 slug
includeTags포함할 태그, 쉼표로 구분
excludeTags제외할 태그, 쉼표로 구분
sortlatest 또는 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이미 있는 버전