Interfaz pública para consultar las piezas publicadas y descargar archivos.
Buscar piezas
GET /api/search · Parámetros opcionales: q, kind (code ou skill), category y 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"}}
Las respuestas de búsqueda y consulta incluyen sponsor: un objeto con name, url y text, o null si no se configura patrocinador ni enlace de donación. El CLI muestra «Patrocinado por <name>: <text> <url>» en stderr; --quiet lo oculta.
Consultar una pieza
GET /api/items/<id> · El identificador es el número de la pieza. Solo se muestran piezas 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 una pieza
GET /api/items/<id>/download · Devuelve el archivo original como adjunto.
curl -OJ "https://slob4all.com/api/items/1/download"
Subir un archivo
POST /upload · Solicitud multipart: file requerido, accept_license=yes requerido, uploader y note opcionales. Máximo 5 MB. Límite predeterminado: 10 subidas por IP y día; al superarlo 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"}
El archivo pasa por un análisis automático básico antes de la ficha IA. No garantiza que sea seguro. Las detecciones se rechazan y los hallazgos de riesgo alto quedan en cuarentena para revisión.
Estado del servicio
GET /healthz · Sin parámetros; responde HTTP 200 cuando el proceso está activo.
curl "https://slob4all.com/healthz"
{"status":"ok"}
Para agentes
Descarga el buscador CLI y la skill de reutilización. La skill indica buscar código o skills antes de crearlos.
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 devuelve un adjunto text/x-python; GET /api/tools/slob-reuse/SKILL.md devuelve un adjunto text/markdown. No reciben parámetros.
Instala la skill en Claude Code en ~/.claude/skills/slob-reuse/SKILL.md. En Codex, guárdaa en ~/.codex/skills/slob-reuse/SKILL.md o referencia o seu contido desde AGENTS.md.
El CLI usa SLOB_URL como servidor predeterminado; --base-url permite elegir otro.