Skip to content
This repository has been archived by the owner on Dec 23, 2022. It is now read-only.

Apertura degli endpoints CKAN più importanti #1

Open
mindrones opened this issue Mar 24, 2017 · 14 comments
Open

Apertura degli endpoints CKAN più importanti #1

mindrones opened this issue Mar 24, 2017 · 14 comments
Assignees

Comments

@mindrones
Copy link

mindrones commented Mar 24, 2017

Ciao, in primis grazie per aver aperto questo spazio!

Dopo aver letto il post di Giovanni e la nota sull'evoluzione di dati.gov.it mi rendo conto che questa issue potrebbe forse essere inutile, ma in mancanza di una roadmap scrivo qui.

Qualche tempo fa ho testato manualmente quasi tutti gli endpoints CKAN e li ho trovati quasi tutti disabilitati. Assumendo che potrebbe richiedere molto tempo per avere delle API usabili in dati.gov.it [1], è possibile aprire il maggior numero di endpoints possibile così da poter lavorare sui dati attuali?

Divido gli endpoints mancanti per "task".

La necessità forse più impellente è quella di poter richiedere la lista delle entità di un certo tipo presenti in un certo momento:

e non meno importante quella di poter richiedere i metadati degli aggiornamenti più recenti in modo da non dover scaricare ogni giorno tutti i metadati e calcolare le differenze temporali:

Una volta individuato cosa c'è e cosa è cambiato, è necessario ovviamente poter richiedere le singole entità:

Sarebbe molto utile poter cercare:

mentre personalmente non ritengo siano urgenti quelle relative all'autocompletamento:

nè quelle sulle relazioni "sociali" tra risorse (followers, following) e altre cose più "gestionali", diciamo da qui in poi.

Grazie!

[1] Come nota a parte, sarebbe molto utile per ogni iniziativa/progetto pubblicare una "tentative roadmap", anche se cambierà di giorno in giorno, in modo da capire i vostri orizzonti temporali ed evitare di fare troppo "guessing" :)

@vitsca
Copy link

vitsca commented Mar 26, 2017

Salve. Scrivo qui solo per rinforzare l'issue proposto da mindrones. Assolutamente importante per la dinamica dell'utilizzo e ri-utilizzo iniziare a abilitare su dati.gov.it le API CKAN possibili, e fornire una roadmap per gli step successivi, qualora siano davvero necessari.

@giux78
Copy link
Member

giux78 commented Mar 26, 2017

Ciao, grazie a voi. Ogni consiglio e' un aiuto.

La roadmap di sviluppo dovrebbe essere rilasciata a breve, cercando di avere un processo di sviluppo agile evolverá col tempo. Stiamo valutando di cambiare gradualmente da DKAN a CKAN, e quindi l'apertura delle API CKAN standard dovrebbe essere naturale. DKAN non credo che supporti tutte le API che hai elencato.

@aborruso
Copy link

aborruso commented Apr 3, 2017

@giux78 la cosa che dovrebbe essere modificata presto è questa frase della pagina sviluppatori:

Per maggiori informazioni sull’utilizzo delle API di CKAN per la consultazione del catalogo fai riferimento alla documentazione di CKAN.

E inserire al limite l'elenco delle chiamate attualmente possibile.

Grazie

@marciuz
Copy link
Collaborator

marciuz commented Apr 3, 2017

... che è questo http://dkan.readthedocs.io/en/rtd/apis/ckan-dataset.html

Facciamo asap, grazie.

@aborruso
Copy link

aborruso commented Apr 3, 2017

@marciuz grazie a te

@seralf
Copy link

seralf commented Apr 6, 2017

segnalo in caso possa tornare utile come riferimento a qualcuno, visto che si citava OpenAPI/swagger:

in caso una descrizione swagger delle API attuali si può scrivere anche a mano in JSON/YAML, per pubblicarla come file statico sul webserver attuale, in attesa delle future versioni.

@aborruso
Copy link

aborruso commented Apr 27, 2017

Solo un promemoria per modificare la pagina, circoscrivendo alle reali chiamate oggi possibili.
Insisto perché mi sembra importante e utile

@dagoneye
Copy link

Solo un promemoria per modificare la pagina, circoscrivendo alle reali chiamate oggi possibili.
Insisto perché mi sembra importante e utile

Confermo l'importanza di documentare al meglio la pagina degli sviluppatori, inserendo eventualmente anche il link verso la doc di DKAN, fino a che non avvengono modifiche ulteriori come l'adozione di CKAN al posto di DKAN, etc...

@aborruso
Copy link

@dagoneye I agree.

E aggiungerei in ogni caso - oltre il link verso la documentazione DKAN - l'elenco di tutte le chiamate oggi possibili su datigovit (al limite in una pagina del wiki di questo repo).

Perché (almeno fino a qualche settimana fa) non erano abilitate tutte, come ad esempio non era abilitata datastore/search.

@marciuz
Copy link
Collaborator

marciuz commented May 12, 2017

La pagina degli sviluppatori è stata appena aggiornata, con documentazione del metodo ckan_current_package_list_with_resources che permette, tra l'altro, un harvesting dei metadati molto più efficiente rispetto alle chiamate indice/dataset.
Anche il link verso DKAN è stato inserito.

Infine segnalo che il metodo package_search non è disponibile di default su DKAN, né al momento
è previsto uno sviluppo a riguardo nella roadmap di dati.gov.it, nella logica di switch verso CKAN.

@dagoneye
Copy link

grazie @marciuz ora per chi arriva su dati.gov.it è molto più chiaro.
Almeno fino a che sarà presente DKAN su dati.gov.it.

@mindrones cosa ne pensi?

@mindrones
Copy link
Author

@dagoneye si, molto più chiaro ora.
@marciuz sarebbe possibile conoscere la roadmap per CKAN?
Mi aspetterei di trovarla nei Projects (sono linkati nel README come stato di avanzamento) ma la pagina è vuota :/

@giorgialodi
Copy link
Collaborator

La roadmap per CKAN la renderemo disponibile quanto prima, ci stiamo predisponendo per mettere in piedi un po' tutto il percorso. In realtà, un'istanza CKAN di test che usa l'estensione DCAT-AP_IT, è già stata installata ed è già operativa per alcuni dati che sono attualmente riversati su dati.gov.it online. Tuttavia, ci sono ancora diverse cose da applicare prima di passare allo switch completo.

@seralf
Copy link

seralf commented May 23, 2017 via email

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

No branches or pull requests

8 participants