API Sifi

📷

Thumbnails

Genera miniatures d'imatges redimensionades a partir d'imatges S3

GET /api/thumbnail

Genera una miniatura redimensionada d'una imatge

url: URL de la imatge S3 (obligatori)

size: Mida en format WIDTHxHEIGHT, ex: 300x300 o 300x0 (obligatori)

Domini permès: efa-acellec.s3-eu-west-3.amazonaws.com
Mida màxima: 2000px per dimensió
Format de sortida: WebP amb qualitat 90%
Cache: 24 hores
⭐ Autenticació: No requereix token d'autenticació

# Exemple d'URL per generar miniatures (sense token): # Miniatura quadrada 300x300px https://api.educacioicultura.cat/api.php/api/thumbnail?url=https://efa-acellec.s3-eu-west-3.amazonaws.com/fotos/maria.jpg&size=300x300 # Redimensionar només per amplada (manté proporcions) https://api.educacioicultura.cat/api.php/api/thumbnail?url=https://efa-acellec.s3-eu-west-3.amazonaws.com/fotos/maria.jpg&size=300x0 # Nota: La resposta és directament la imatge WebP, no JSON # ⭐ No cal incloure token d'autenticació per a aquest endpoint

👥

Formadores

Accedeix a la informació dels formadors amb els seus cursos actuals

GET /api/formadores

Obtenir tots els formadors amb paginació i ordenació aleatòria

page: Número de pàgina (per defecte: 1)

limit: Elements per pàgina (per defecte: 10, màxim: 100)

seed: Llavor per ordenació aleatòria consistent - numèrica o alfanumèrica (opcional)
GET /api/formadores/{id}

Obtenir un formador específic per ID amb els seus cursos
GET /api/formadores/search

Cercar formadors

q: Terme de cerca (obligatori)

page, limit, seed: Opcionals

🤝

Convenis EFA

Accedeix als convenis públics amb entitats i organitzacions

GET /api/convenis_efa

Obtenir tots els convenis públics amb paginació i ordenació aleatòria

page: Número de pàgina (per defecte: 1)

limit: Elements per pàgina (per defecte: 10, màxim: 100)

seed: Llavor per ordenació aleatòria consistent (opcional)
GET /api/convenis_efa/{id}

Obtenir un conveni específic per ID
GET /api/convenis_efa/search

Cercar i filtrar convenis per camps específics

q: Cerca general en tots els camps (opcional)

organization: Filtrar per nom d'organització (text)

espai_migdia: Filtrar per espai migdia (0 o 1)

extraescolars: Filtrar per extraescolars (0 o 1)

casal: Filtrar per casal (0 o 1)

colònies: Filtrar per colònies (0 o 1)

campaments: Filtrar per campaments (0 o 1)

ludoteca: Filtrar per ludoteca (0 o 1)

altres: Filtrar per altres serveis (text)

url: Filtrar per URL (text)

Valors dels camps: 0 = No, 1 = Sí
Filtres combinables: Pots usar múltiples filtres simultàniament

# EXEMPLES D'ÚS DE FILTRES: # 1. Filtrar per un servei específic GET /api/convenis_efa/search?casal=1 # 2. Combinar múltiples filtres GET /api/convenis_efa/search?extraescolars=1&ludoteca=0 # 3. Filtrar per organització GET /api/convenis_efa/search?organization=Barcelona # 4. Cerca general GET /api/convenis_efa/search?q=Barcelona # 5. Combinar cerca i filtres GET /api/convenis_efa/search?q=cultural&casal=1 # 6. Múltiples filtres + paginació GET /api/convenis_efa/search?extraescolars=1&espai_migdia=1&page=1&limit=20 # ERROR: Sense paràmetres GET /api/convenis_efa/search # Retorna: "Search query or filter parameters required"

🗺️

Mapa

Accedeix a les ubicacions dels equipaments de formació

GET /api/mapa

Obtenir totes les ubicacions d'equipaments

ET

Equip Tècnic

Accedeix a la informació dels membres de l'equip tècnic

GET /api/et

Obtenir tots els membres de l'equip tècnic

🎓

Qualificacions

Consulta informació de convocatòries i resultats

GET /api/qualificacions

Obtenir la convocatòria activa
GET /api/qualificacions?document={nif}

Consultar resultat amb document

⭐

Destacats

Cursos destacats a la pàgina principal amb sessions i formadors

GET /api/destacats

Obtenir tots els cursos destacats amb les seves sessions i formadors associats

{ "success": true, "data": [ { "id": "123", "course": "Nom del curs", "subtitle": "Subtítol del curs", "starts": "2024-01-15", "ends": "2024-03-20", "funded": "1", "fundae": "1", "photo": "https://efa-acellec.s3-eu-west-3.amazonaws.com/formacio/image.jpg", "slug": "nom-del-curs", "location": "Barcelona", "online": "0", "closed": "0" } ], "total": 1 }

🎯

Itineraris

Llista d'itineraris formatius

GET /api/itineraris

Obtenir tots els itineraris

{ "success": true, "data": [ { "id": "5", "itinerari": "Pedagogia Digital", "description": "Itinerari centrat en la pedagogia digital i les noves metodologies educatives", "icon": "https://efa-acellec.s3-eu-west-3.amazonaws.com/itineraris/pedagogia-digital.png", "slug": "pedagogia-digital" }, { "id": "6", "itinerari": "Gestió Educativa", "description": "Formació en gestió i administració de centres educatius", "icon": "https://efa-acellec.s3-eu-west-3.amazonaws.com/itineraris/gestio-educativa.png", "slug": "gestio-educativa" }, { "id": "7", "itinerari": "Tecnologia i Innovació", "description": "Eines tecnològiques i innovació en l'educació", "icon": "https://efa-acellec.s3-eu-west-3.amazonaws.com/itineraris/tecnologia-innovacio.png", "slug": "tecnologia-innovacio" } ], "total": 3 }
GET /api/itineraris/{slug}

Obtenir detalls d'un itinerari per slug amb catàleg paginat i itineraris relacionats

slug: Slug de l'itinerari (text, a la URL)

cataleg_page: Número de pàgina del catàleg (per defecte: 1)

cataleg_limit: Elements per pàgina del catàleg (per defecte: 10, màxim: 100)

# EXEMPLES D'ÚS: # Obtenir itinerari per slug (paginació per defecte) GET /api/itineraris/pedagogia-digital # Amb paginació personalitzada GET /api/itineraris/pedagogia-digital?cataleg_page=1&cataleg_limit=20 # Segona pàgina amb 15 elements GET /api/itineraris/gestio-educativa?cataleg_page=2&cataleg_limit=15

{ "success": true, "data": { "id": "5", "itinerari": "Pedagogia Digital", "description": "Itinerari centrat en la pedagogia digital i les noves metodologies educatives", "icon": "https://efa-acellec.s3-eu-west-3.amazonaws.com/itineraris/pedagogia-digital.png", "slug": "pedagogia-digital", "cataleg": [ { "id": "101", "course": "Gestió d'Aula Avançada", "photo": "https://efa-acellec.s3-eu-west-3.amazonaws.com/formacio/gestio-aula.jpg", "slug": "gestio-aula-avancada" }, { "id": "102", "course": "Metodologies Actives", "photo": "https://efa-acellec.s3-eu-west-3.amazonaws.com/formacio/metodologies.jpg", "slug": "metodologies-actives" } ], "cataleg_pagination": { "page": 1, "limit": 10, "total": 25, "pages": 3 }, "related": [ { "id": "6", "itinerari": "Gestió Educativa", "description": "Formació en gestió i administració de centres educatius", "icon": "https://efa-acellec.s3-eu-west-3.amazonaws.com/itineraris/gestio-educativa.png", "slug": "gestio-educativa" }, { "id": "8", "itinerari": "Lideratge Pedagògic", "description": "Desenvolupament del lideratge en l'àmbit educatiu", "icon": "https://efa-acellec.s3-eu-west-3.amazonaws.com/itineraris/lideratge.png", "slug": "lideratge-pedagogic" } ] } }

📚

Catàleg

Catàleg formatiu amb temàtiques, cursos i ofertes associades

GET /api/cataleg

Obtenir el catàleg complet amb temàtiques i ofertes, amb cerca i filtres

page: Número de pàgina (per defecte: 1)

limit: Elements per pàgina (per defecte: 10, màxim: 100)

course: Cercar per nom del curs (text)

idthematic: Filtrar per ID de temàtica (número)

thematic: Filtrar per nom de temàtica (text)

iditinerary: Filtrar per ID d'itinerari (número)

itinerary: Filtrar per nom d'itinerari (text)

# EXEMPLES D'ÚS: # 1. Obtenir tot el catàleg (primera pàgina) GET /api/cataleg # 2. Paginació GET /api/cataleg?page=2&limit=20 # 3. Cercar per nom de curs GET /api/cataleg?course=gestió # 4. Filtrar per temàtica (per ID) GET /api/cataleg?idthematic=5 # 5. Filtrar per itinerari (per nom) GET /api/cataleg?itinerary=Pedagogia # 6. Combinar cerca i filtres GET /api/cataleg?course=educació&idthematic=3&page=1&limit=15

{ "success": true, "tematiques": [ { "id": "1", "thematic": "Pedagogia" }, { "id": "2", "thematic": "Tecnologia Educativa" } ], "cataleg": [ { "id": "101", "course": "Gestió d'Aula", "subtitle": "Subtítol del curs", "slug": "gestio-aula", "photo": "https://efa-acellec.s3-eu-west-3.amazonaws.com/formacio/image.jpg", "idthematic": "1", "thematic": "Pedagogia" } ], "pagination": { "page": 1, "limit": 10, "total": 45, "pages": 5 } }
GET /api/cataleg/{slug}

Obtenir informació completa d'un curs del catàleg per slug amb cursos relacionats

slug: Slug del curs (text, a la URL)

# EXEMPLES D'ÚS: # Obtenir curs del catàleg per slug GET /api/cataleg/gestio-aula-avancada GET /api/cataleg/metodologies-actives GET /api/cataleg/avaluacio-competencial

{ "success": true, "data": { "id": "101", "course": "Gestió d'Aula Avançada", "subtitle": "Subtítol del curs", "description": "Descripció completa del curs de gestió d'aula...", "public": "Mestres i professors d'educació primària i secundària", "syllabus": "Continguts del curs: 1. Gestió de l'aula...", "objectives": "Objectius d'aprenentatge: Millorar les habilitats...", "methodology": "Metodologia aplicada: Sessions pràctiques...", "observations": "Observacions addicionals...", "photo": "https://efa-acellec.s3-eu-west-3.amazonaws.com/formacio/gestio-aula.jpg", "slug": "gestio-aula-avancada", "iditinerary": "5", "itinerary": "Pedagogia Digital", "color": "#FF5733", "idthematic": "1", "thematic": "Pedagogia", "related": [ { "id": "102", "course": "Metodologies Actives", "subtitle": "Subtítol del curs relacionat", "photo": "https://efa-acellec.s3-eu-west-3.amazonaws.com/formacio/metodologies.jpg", "slug": "metodologies-actives" }, { "id": "103", "course": "Avaluació Competencial", "subtitle": "Subtítol del curs relacionat", "photo": "https://efa-acellec.s3-eu-west-3.amazonaws.com/formacio/avaluacio.jpg", "slug": "avaluacio-competencial" } ] } }

📅

Actual

Cursos actuals amb sessions i formadors, temàtiques i ubicacions

GET /api/actual

Obtenir cursos actius amb filtres, sessions i formadors

page: Número de pàgina (per defecte: 1)

limit: Elements per pàgina (per defecte: 10, màxim: 100)

course: Cercar per nom del curs (text)

idthematic: Filtrar per ID de temàtica (número)

funded: Filtrar per subvencionat (0 o 1)

teachers: Filtrar per professorat (0 o 1)

fundae: Filtrar per bonificable FUNDAE (0 o 1)

professionalism: Filtrar per professionalitat (0 o 1)

online: Filtrar per modalitat online (0 o 1)

location: Filtrar per ubicació (text exacte)

# EXEMPLES D'ÚS: # 1. Obtenir tots els cursos actuals GET /api/actual # 2. Cercar per nom de curs GET /api/actual?course=gestió # 3. Filtrar per temàtica GET /api/actual?idthematic=5 # 4. Filtrar cursos subvencionats GET /api/actual?funded=1 # 5. Filtrar bonificables FUNDAE GET /api/actual?fundae=1 # 6. Filtrar amb professorat GET /api/actual?teachers=1 # 7. Filtrar cursos online GET /api/actual?online=1 # 8. Filtrar per ubicació GET /api/actual?location=Barcelona # 9. Combinar múltiples filtres GET /api/actual?course=pedagogia&funded=1&location=Barcelona&online=0&page=1&limit=20 GET /api/actual?funded=1 # 5. Filtrar bonificables FUNDAE GET /api/actual?fundae=1 # 6. Filtrar amb professorat GET /api/actual?teachers=1 # 7. Combinar múltiples filtres GET /api/actual?course=pedagogia&funded=1&teachers=1&page=1&limit=20

{ "success": true, "tematiques": [ { "id": "1", "thematic": "Pedagogia" }, { "id": "2", "thematic": "Tecnologia Educativa" } ], "locations": [ "Barcelona", "Girona", "Lleida", "Tarragona" ], "courses": [ { "id": "123", "course": "Gestió d'Aula Avançada", "subtitle": "Edició primavera 2024", "starts": "2024-03-01", "ends": "2024-05-15", "funded": "1", "fundae": "1", "photo": "https://efa-acellec.s3-eu-west-3.amazonaws.com/formacio/image.jpg", "slug": "gestio-aula-avancada", "location": "Barcelona", "online": "0", "closed": "0" } ], "pagination": { "page": 1, "limit": 10, "total": 67, "pages": 7 } }
GET /api/actual/{slug}

Obtenir informació completa d'un curs actiu per slug amb formadors, sessions i cursos relacionats

slug: Slug del curs (text, a la URL)

# EXEMPLES D'ÚS: # Obtenir curs actiu per slug GET /api/actual/gestio-aula-avancada GET /api/actual/metodologies-actives GET /api/actual/avaluacio-competencial

{ "success": true, "data": { "id": "123", "course": "Gestió d'Aula Avançada", "subtitle": "Edició primavera 2024", "starts": "2024-03-01", "ends": "2024-05-15", "hours": "30", "funded": "1", "teachers": "Equip docent EFA", "professionalism": "1", "foap": "0", "fundae": "1", "price": "150.00", "price_associates": "120.00", "description": "Descripció completa del curs...", "public": "Mestres i professors", "syllabus": "Continguts del curs...", "objectives": "Objectius d'aprenentatge...", "methodology": "Metodologia aplicada...", "observations": "Observacions addicionals...", "photo": "https://efa-acellec.s3-eu-west-3.amazonaws.com/formacio/image.jpg", "slug": "gestio-aula-avancada", "location": "Barcelona", "online": "0", "closed": "0", "iditinerary": "5", "itinerary": "Pedagogia Digital", "color": "#FF5733", "idthematic": "1", "thematic": "Pedagogia", "form": "https://espaipersonal.escolaefa.cat/alumnes/in.php?id=123", "formadores": [ { "id": "10", "nom": "Maria", "cognom_1": "García", "cognom_2": "López" } ], "sessions": [ { "id": "456", "data": "2024-03-05", "inici": "10:00:00", "final": "13:00:00" } ], "related": [ { "id": "124", "course": "Metodologies Actives", "subtitle": "Edició tardor 2024", "starts": "2024-09-15", "ends": "2024-11-30", "funded": "1", "fundae": "1", "photo": "https://efa-acellec.s3-eu-west-3.amazonaws.com/formacio/metodologies.jpg", "slug": "metodologies-actives", "location": "Barcelona", "online": "0", "closed": "0" } ] } }

📧

Subscriptores

Subscripció a la newsletter

POST /api/subscriptores

Subscriure un email

email: Adreça de correu (obligatori)

gdpr: Consentiment (opcional, per defecte: 1)

Autenticació

Capçalera d'Autorització (Recomanat)

Paràmetre de Consulta