Gestió de dades

Els serveis REST d’Arts Combinatòries proporcionen accés CRUD a les dades. Tota comunicació es fa en format JSON.

Upload

Crea un nou objecte d’un tipus i amb un conjunt de dades determinades

Ruta servei: http://{host:port}/{appname}/resource/upload
Mètode HTTP: PUT
Contingut acceptat: */json
Retorna: L'identificador de l'objecte creat o bé "error"

El cos de la crida HTTP ha de contenir una llista JSON de tuples nom-valor.

“type” o “rdf:type” és una dada requerida, altrament retorna error.

“about” és una dada recomanada per tal de generar adequadament l’identificador.

Les propietats poden contenir valors multilingües, en aquest cas cal incloure el prefix d’idioma (veure exemple).

Exemple PUT

http://internetdomain.org/ac/resource/upload

{
    "type":"Location",
    "about":"New York City",
    "my:name":"New York City@en",
    "my:name":"Nova York@ca",
    "my:abbreviation":"NYC"
}

El prefix d’idioma és ‘@’ més el codi d’idioma.

Resultat OK

"New_York_City"

Read

Retorna les dades d’un objecte específic

Ruta servei: http://{host:port}/{appname}/resource/{identifier}
Mètode HTTP: GET
Retorna: dades JSON

Exemple GET

http://internetdomain.org/ac/resource/New_York_City

Resultat OK

{
    "rdf:type":"Location",
    "about":"New York City",
    "my:name":"New York City@en",
    "my:name":"Nueva York@es",
    "my:abbreviation":"NYC"
}

Exists

Informa si existeix un determinat objecte

Ruta servei: http://{host:port}/{appname}/resource/{identifier}/exists
Mètode HTTP: GET
Retorna: "true" o "false"

Exemple GET

http://internetdomain.org/ac/resource/New_York_City/exists

Resultat OK

"true"

Update

Actualitza les dades d’un objecte específic.

Ruta servei: http://{host:port}/{appname}/resource/{identifier}/update
Mètode HTTP: POST
Contingut acceptat: */json
Retorna: "success" o "error"

El cos de la crida HTTP ha de contenir una llista JSON de tuples nom-valor.

Per tal d’esborrar alguna propietat existent, aquesta s’ha d’enviar amb un valor buit. Les propietats no enviades no pateixen cap modificació.

L’identificador i el tipus no es poden canviar.

Exemple POST

http://internetdomain.org/ac/resource/New_York_City/update

    // Partint de l'exemple anterior
{
    "type":"Person",            // no té cap efecte (el mateix per "rdf:type")
    "name":"City of New York"   // canvia el valor (i passa a tenir un sol valor)
    "abbrevitation":"",         // esborra la propietat
    "population":"8175133",     // crea la propietat
}

Resultat OK

"success"

Delete

Esborra un objecte específic

Ruta servei: http://{host:port}/{appname}/resource/{identifier}/delete
Mètode HTTP: DELETE
Retorna: "success" o "error"