Skip to content

Resolver citas APIv2

Tomas Saez B edited this page Dec 13, 2016 · 7 revisions

Endpoint de resolución de referencias. Puede recibir cualquier número de referencias en texto plano; si es sólo una el endpoint trabaja de manera instantánea, y de otro modo se comporta de manera diferida.

La idea de este endpoint es realizar el workflow completo, es decir, tomar cada una de las referencias en texto plano y busca su información para generar un JSON estándar. A continuación se procede a buscar sus referencias respectivas.

###URL

/api/v2/resolve

###Métodos: GET

###Parámetros URL

q=[string] La referencia en texto plano a buscar. La solicitud puede contener cualquier número de referencias, las cuales se agruparán internamente en una lista.

###Solicitud Exitosa

Dada una solicitud exitosa, se entregará una id correspondiente al job asociado.

Código: 202
Contenido:

{
    "job": "IjY4Zjc3NjRkLTY...",
    "submitted": "1970-01-01T00:00:00.000000+00:00"
}

###Solicitud Fallida

En caso de no incluir una referencia, el servidor responde con un mensaje de error:

Código: 400 BAD REQUEST
Contenido:

{
    "message": {
        "length": "Missing required parameter in the JSON body or the post body or the query string"
    }
}

###Ejemplos

En caso de consultar por el job y que este se encuentre terminado, se retorna un JSON con la información respectiva :

Contenido:

{
  "result_ttl": 300,
  "timestamp": "2016-12-13T14:53:22",
  "result": [
    {
      "abstract": null,
      "publication_type": {
        "cited_medium": null,
        "issn": "0717-6384",
        "volume": "16",
        "title": "Medwave",
        "pagination": "e6438-e6438",
        "issue": "Suppl2",
        "year": 2016
      },
      "rating": {
        "year": 1,
        "authors": 0.95,
        "total": 0.9874999999999999,
        "title": 1
      },
      "ids": {
        "embase": null,
        "doi": "10.5867/medwave.2016.6438",
        "pubmed": null,
        "scopus": null
      },
      "references": {
            "..."
      },
      "title": "Is racecadotril effective for acute diarrhea in children? -First update",
      "language": null,
      "authors": [
        {
          "given": "Josefina",
          "family": "Sáez"
        },
        {
          "given": "Lorena",
          "family": "Cifuentes"
        }
      ],
      "source": "CrossRef",
      "type": "journal-article"
    }
  ],
  "done": true,
  "length": 1
}