Interfície pública per consultar les peces publicades i baixar-ne els fitxers.
Cerca peces
GET /api/search · Paràmetres opcionals: q, kind (code o skill), category i 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"}}
Les respostes de cerca i consulta inclouen sponsor: un objecte amb name, url i text, o null si no es configura cap patrocinador ni enllaç de donació. El CLI mostra «Patrocinat per <name>: <text> <url>» a stderr; --quiet l’amaga.
Consulta una peça
GET /api/items/<id> · L’identificador és el número de la peça. Només es mostren les peces publicades.
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"}}
Baixa una peça
GET /api/items/<id>/download · Retorna el fitxer original com a adjunt.
curl -OJ "https://slob4all.com/api/items/1/download"
Pujar un fitxer
POST /upload · Sol·licitud multipart: file obligatori, accept_license=yes obligatori, uploader i note opcionals. Màxim 5 MB. Límit predeterminat: 10 pujades per IP i dia; si se supera, respon 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 fitxer passa per una anàlisi automàtica bàsica abans de crear-ne la fitxa d’IA. No en garanteix la seguretat. Les deteccions es rebutgen i les troballes d’alt risc queden en quarantena per revisar-les.
Estat del servei
GET /healthz · Sense paràmetres; respon HTTP 200 quan el procés està actiu.
curl "https://slob4all.com/healthz"
{"status":"ok"}
Per a agents
Baixa el cercador CLI i l’skill de reutilització. L’skill recomana cercar codi o skills abans de crear-ne.
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 retorna un adjunt text/x-python; GET /api/tools/slob-reuse/SKILL.md retorna un adjunt text/markdown. No reben paràmetres.
Instal·la l’skill a Claude Code a ~/.claude/skills/slob-reuse/SKILL.md. A Codex, desa-la a ~/.codex/skills/slob-reuse/SKILL.md o referencia’n el contingut des de AGENTS.md.
El CLI fa servir SLOB_URL com a servidor predeterminat; --base-url permet triar-ne un altre.