Interface pública para consultar as pezas publicadas e descargar ficheiros.
Buscar pezas
GET /api/search · Parámetros opcionais: q, kind (code o skill), category e tag.
curl "https://slob4all.com/api/search?q=parser&kind=code&category=utilidades&tag=texto"
{"items":[{"id":1,"kind":"code","filename":"parser.py","status":"published","sheet":{"title":"Parser reutilizable","summary":"Lee texto","categories":["utilidades"],"tags":["texto"]}}],"sponsor":{"name":"SLOB IA 4 ALL","url":"https://example.org/apoya","text":"Texto del patrocinador"}}
As respostas de busca e consulta inclúen sponsor: un obxecto con name, url e text, ou null se non se configura patrocinador nin ligazón de doazón. O CLI mostra «Patrocinado por <name>: <text> <url>» en stderr; --quiet ocúltao.
Consultar unha peza
GET /api/items/<id> · O identificador é o número da peza. Só se amosan pezas publicadas.
curl "https://slob4all.com/api/items/1"
{"id":1,"kind":"code","filename":"parser.py","status":"published","sheet":{"title":"Parser reutilizable","summary":"Lee texto"},"sponsor":{"name":"SLOB IA 4 ALL","url":"https://example.org/apoya","text":"Texto del patrocinador"}}
Descargar unha peza
GET /api/items/<id>/download · Devolve o ficheiro orixinal como anexo.
curl -OJ "https://slob4all.com/api/items/1/download"
Subir un ficheiro
POST /upload · Solicitude multipart: file obrigatorio, accept_license=yes obrigatorio, uploader e note opcionais. Máximo 5 MB. O límite predeterminado é de 10 subidas por IP e día; ao superalo responde HTTP 429.
curl -F '[email protected]' -F 'accept_license=yes' -F 'uploader=Ana' -F 'note=Revisar' https://slob4all.com/upload
{"id":2,"duplicate":false,"status":"scanning"}
O ficheiro pasa por unha análise automática básica antes da ficha IA. Non garante que sexa seguro. As deteccións rexéitanse e os achados de risco alto quedan en corentena para revisión.
Estado do servizo
GET /healthz · Sen parámetros; responde HTTP 200 cando o proceso está activo.
curl "https://slob4all.com/healthz"
{"status":"ok"}
Para axentes
Descarga o buscador CLI e a skill de reutilización. A skill indica buscar código ou skills antes de crealos.
curl -OJ "https://slob4all.com/api/tools/slob-find" curl -OJ "https://slob4all.com/api/tools/slob-reuse/SKILL.md"
GET /api/tools/slob-find devolve un anexo text/x-python; GET /api/tools/slob-reuse/SKILL.md devolve un anexo text/markdown. Non reciben parámetros.
Instala a skill en Claude Code en ~/.claude/skills/slob-reuse/SKILL.md. En Codex, gárdaa en ~/.codex/skills/slob-reuse/SKILL.md ou referencia o seu contido desde AGENTS.md.
O CLI usa SLOB_URL como servidor predeterminado; --base-url permite escoller outro.