Application Programming Interface

71
APPLICATION PROGRAMMING INTERFACE SANTIAGO MARTÍNEZ DE LA RIVA [email protected] Unidad de Coordinación GBIF.es Taller de Formación del Portal Internacional GBIF.ORG API

description

Application Programming Interface. SANTIAGO MARTÍNEZ DE LA RIVA [email protected] Unidad de Coordinación GBIF.es Taller de Formación del Portal Internacional GBIF.ORG. API. ÍNDICE_. APPLICATION PROGRAMMING INTERFACE. 1. ¿Qué es una API? ( wiki ). - PowerPoint PPT Presentation

Transcript of Application Programming Interface

Page 1: Application Programming  Interface

APPLICATION PROGRAMMING INTERFACE

SANTIAGO MARTÍNEZ DE LA [email protected]

Unidad de Coordinación GBIF.esTaller de Formación del Portal

Internacional GBIF.ORG

API

Page 2: Application Programming  Interface

ÍNDICE_

1. ¿Qué es una API?• Explicación.• Respuestas.

Formato. Manejo.

• Ejemplos y Aplicaciones.

2. APIs de GBIF.org:• Introducción.• Información a

consultar: A nivel del

Registro. A nivel de las

Especies. A nivel de

Especímenes y Observaciones.

A nivel de Mapa.

Page 3: Application Programming  Interface

- Es una interfaz de comunicación entre un servidor y sus clientes.

- Este interfaz de comunicación (API), nos proporciona un lenguaje para poder comunicarnos con el servidor, de manera que podamos establecer una conversación con él, y así poder obtener información del mismo.

- El lenguaje a través del cual nos comunicamos con el servidor, tiene un formato específico de cada servidor.

1. ¿Qué es una API? (wiki)

APPLICATION PROGRAMMING INTERFACE

Page 4: Application Programming  Interface

- FORMATO:

1. ¿Qué es una API?

APPLICATION PROGRAMMING INTERFACE

http://api.gbif.org/v0.9/ dataset ? q=VAL & country=SPAIN

Nombre de la API(Constate)

Etiqueta ParámetrosAtributo=Valor

Concatena los parámetros

Indicador

Page 5: Application Programming  Interface

- FLUJO DE INFORMACIÓN:

1. ¿Qué es una API?

APPLICATION PROGRAMMING INTERFACE

SERVIDOR

S.I CLIEN

TEAPI(Lenguaje

de comunicación)

http://api.gbif.org/v0.9/dataset?q=VAL&country=SPAIN 1

2

3 4Respuest

a(JSON)

• Sistema de registro• GBIF Taxonomic

Backbone (nub) (y otras checklist)

• GBIF Occurrence Storage• Sistemas de

georreferenciación

SolicitudAnálisis

5Visualizació

n/

Lectura de la

respuesta

-CRUD-

Page 6: Application Programming  Interface

{"offset":0,"limit":20,"endOfRecords":true,"results":[{"key":2435099, "kingdom":"Animalia", "phylum":"Chordata", "clazz":"Mammalia", "order":"Carnivora","family":"Felidae","genus":"Puma","species":"Pumaconcolor","kingdomKey":1,"phylumKey":44,"classKey":359,"orderKey":732,"familyKey":9703,"genusKey":2435098,"speciesKey":2435099,"datasetKey":"d7dddbf4-2cf0-4f39-9b2a-bb099caae36c", "nubKey":2435099,"parentKey":2435098,"parent":"Puma","scientificName":"Puma con color (Linnaeus, 1771)","canonicalName":"Puma concolor“ ,"vernacularName":"Puma", "authorship":"(Linnaeus,1771)“ ,"nameType":"WELLFORMED","rank":"SPECIES", "origin":"SOURCE", "taxonomicStatus":"ACCEPTED", "nomenclaturalStatus":[],"publishedIn":"Mantissa Plantarum vol. 2 p. 266","accordingTo":"The Catalogue of Life, 3rd January 2011", "numDescendants":6, "identifiers":[{"key":1155098,"usageKey":2435099,"datasetKey":"d7dddbf4-2cf0-4f39-9b2a-bb099caae36c","identifier":"119806678","type":"SOURCE_ID"}],"synonym":false, "sourceId":"119806678"}, …,{}]}

APPLICATION PROGRAMMING INTERFACE

1. ¿Qué es una API?

- FORMATO LIGERO DE INTERCAMBIO DE DATOS (JSON):

-MANEJO DE LA RESPUESTA: http://161.111.171.204/apidataportal.php

Page 7: Application Programming  Interface

1. ¿Qué es una API?

APPLICATION PROGRAMMING INTERFACE

- EJEMPLOS y APLICACIONES:

1. API del Open Geospatial Consortium (OGC) aportadas por actores participantes en el proyecto IDEE. http://www.idee.es/web/guest/ejemplos-de-api

2. API de Google Maps: Sitio Oficial y Documentación.3. Youtube: Sitio Oficial y Documentación.4. Amazon S3: Sitio Oficial y Documentación.5. Facebook: Sitio Oficial y Documentación.6. Flickr: Sitio Oficial y Documentación.

Page 8: Application Programming  Interface

SISTEMA DE REGISTRO - DATASET

APPLICATION PROGRAMMING INTERFACE(API)

Page 10: Application Programming  Interface

URL Método Respuesta Descripción Auth Paging

/dataset/{UUID}/contact GET Contactos de

UNEXLista de contactos del dataset. NO NO

/dataset/{UUID}/contact POST ID Crea y añade un

nuevo contacto. SI NO

/dataset/{UUID}/contact/{ID} PUT Actualiza el

contacto. SI NO

/dataset/{UUID}/contact/{ID} DELETE Borra el contacto SI NO

DATASET + CONTACTOS

SISTEMA DE REGISTRO

Page 11: Application Programming  Interface

URL Método Respuesta Descripción Auth Paging

/dataset/{UUID}/endpoint GET Endpoints

del Herbario LEB

Lista de puntos de acceso. NO NO

/dataset/{UUID}/endpoint POST ID Crea y añade un nuevo punto

de acceso. SI NO

/dataset/{UUID}/endpoint/{ID} DELETE Borra el punto de acceso. SI NO

DATASET + ENDPOINTS

SISTEMA DE REGISTRO

Page 12: Application Programming  Interface

URL Método Respuesta Descripción Auth Paging

/dataset/{UUID}/identifier GET Lista de

identificadores de BC

Lista de identificadores. NO NO

/dataset/{UUID}/identifier POST ID Crea y añade un nuevo

identificador. SI NO

/dataset/{UUID}/identifier/{ID} DELETE Borra el identificador. SI NO

DATASET + IDENTIFICADORES

SISTEMA DE REGISTRO

Page 13: Application Programming  Interface

URL Método Respuesta Descripción Auth Paging

/dataset/{UUID}/tag GET Tags de Bos-odo

Lista de todas las etiquetas. NO NO

/dataset/{UUID}/tag POST ID Crea y añade un nueva etiqueta. SI NO

/dataset/{UUID}/tag/{ID} DELETE Borra la etiqueta. SI NO

DATASET + ( TAGS / MACHINE TAGS) (explicación)

URL Método Respuesta Descripción Auth Paging

/dataset/{UUID}/machinetag GET Machinetags

de Bos-odoLista de todas las etiquetas. NO NO

/dataset/{UUID}/machinetag POST ID Crea y añade un

nueva etiqueta. SI NO

/dataset/{UUID}/machinetag/{ID} DELETE Borra la etiqueta. SI NO

SISTEMA DE REGISTRO

Page 14: Application Programming  Interface

URL Método Respuesta Descripción Auth Paging

/dataset/{UUID}/comment GET Comentarios s

obre el Herbario

EMMA

Lista de comentarios. NO NO

/dataset/{UUID}/comment POST ID Crea y añade un nuevo

comentario. SI NO

/dataset/{UUID}/comment/{ID}

DELETE Borra el comentario. SI NO

SISTEMA DE REGISTRO

DATASET + COMENTARIOS

Page 15: Application Programming  Interface

URL Método Respuesta Descripción Auth Paging

/dataset/{UUID}/constituents

GET Subdataset de MCNM-Cord

Lista todos los subdataset. (parentDatasetKey)

NO SI

SISTEMA DE REGISTRO

DATASET + SUBDATASET

DATASET + METADATAURL Método Respuesta Descripción Auth Paging

/dataset/{UUID}/document

GET EML de Sinfonevada. EML del dataset. NO NO

/dataset/{UUID}/document

POSTActualiza el EML del dataset reemplazando el antiguo..

SI NO

Page 16: Application Programming  Interface

URL Método Respuesta Descripción Auth Paging Parámetros

/dataset/{UUID}/metadata GET Metadatos

de nzor

Visualiza los metadatos. NO NO Type

(DC, EML)

/dataset/metadata/{ID} GET Metadatos

del checklist de

nzor

Devuelve la descripción con ese ID.

NO NO

/dataset/metadata/{ID}/document

GET EMLDevuelve el documento asociado.

NO NO

/dataset/metadata/{ID}/ DELETE Borra el

metadato. SI NO

DATASET type = METADATA

SISTEMA DE REGISTRO

Page 17: Application Programming  Interface

URL Método Respuesta Auth Paging

/dataset/deleted GET Lista de borrados NO SI

/dataset/duplicate GET Lista de dataset duplicados

NO SI

/dataset/withNoEndpoint GET Lista de los dataset que no tienen puntos de acceso

NO SI

SISTEMA DE REGISTRO

DATASET

Page 18: Application Programming  Interface

URL Método Respuesta Descripción Paging Parámetros

/dataset/search

GETDataset que contengan la palabra

plant y se hayan publicado en España, en el 2010

Búsqueda sobre todo el listado de dataset. El resultado se ordena por relevancia.

SIq, country, type

, keyword,owning_org,hosting_org, decade,publishing_country,

/dataset/suggest

GET Dataset de BC publicados por GBIF

España

Devuelve los 20 primeros dataset, ordenados por relevancia.

SI

q, country, type, keyword,

owning_org (uuid),hosting_org(uuid), decade,

publishing_country,

BÚSQUEDA DE DATASET

SISTEMA DE REGISTRO

NOTA: Keywords = Tags + keywordCollections + temporalCoverages

Page 19: Application Programming  Interface

URL Método Respuesta Descripción Paging

/dataset_metrics/{UUID} GET

Estadísticas de GBIF Taxonomy Backbone

Devuelve varios datos estadísticos de una checklist. • Número de especies.• Número de sinónimos.• Cuenta por rangos.• Cantidad de nombres

vernáculos por idioma,…

SI

DATOS ESTADÍSTICOS DEL DATASET (type = checklist)

SISTEMA DE REGISTRO

Page 20: Application Programming  Interface

SISTEMA DE REGISTRO - INSTALACIONES

APPLICATION PROGRAMMING INTERFACE(API)

Page 21: Application Programming  Interface

URL Método Respuesta Descripción Auth Paging Parámetros

/installation GET Lista Lista todas las instalaciones. NO SI

q, identifier, identifierType

/installation POST UUID Crea una nueva instalación SI NO

/installation/{UUID} GET Instalación

IPT de GBIF.es

Detalles de la instalación. NO NO

/installation/{UUID} PUT Actualiza la

instalación. SI NO

/installation/{UUID} DELETE Borra la

instalación. SI NO

INSTALACIONES

SISTEMA DE REGISTRO

Page 22: Application Programming  Interface

URL Método Respuesta Descripción Auth Paging

/installation/{UUID}/contact GET Contactos de

la instalación de GBIF.es

Lista de contactos de la instalación. NO NO

/installation/{UUID}/contact POST ID Crea y añade un

nuevo contacto. SI NO

/installation/{UUID}/contact/{ID} PUT Actualiza el

contacto. SI NO

/installation/{UUID}/contact/{ID} DELETE Borra el contacto SI NO

INSTALACIONES + CONTACTOS

SISTEMA DE REGISTRO

Page 23: Application Programming  Interface

URL Método Respuesta Descripción Auth Paging

/installation/{UUID}/endpoint

GET rss Lista los puntos de acceso de la instalación. NO NO

/installation/{UUID}/endpoint

POST ID Crea y añade un nuevo punto de acceso a la instalación. SI NO

/installation/{UUID}/endpoint/{ID}

DELETE Borra el punto de acceso de la instalación. SI NO

INSTALACIONES + ENDPOINTS

SISTEMA DE REGISTRO

Page 24: Application Programming  Interface

URL Método Respuesta Descripción Auth Paging

/installation/{UUID}/identifier GET Listado de los id

entificadores de GBIF Francia.

Lista de identificadores de la instalación. NO NO

/installation/{UUID}/identifier POST ID

Crea y añade un nuevo identificador a la instalación.

SI NO

/installation/{UUID}/identifier/{ID}

DELETE Borra el identificador de la instalación. SI NO

SISTEMA DE REGISTRO

INSTLACIONES + IDENTIFICADORES

Page 25: Application Programming  Interface

URL Método Respuesta Descripción Auth Paging

/installation/{UUID}/tag GET Tags de GBIF.es Lista todas las

etiquetas de la inst. NO NO

/installation/{UUID}/tag POST ID Crea y añade un nueva

etiqueta. SI NO

/installation/{UUID}/tag/{ID} DELETE Borra la etiqueta. SI NO

INSTALACIONES + ( TAGS / MACHINE TAGS)

URL Método Respuesta Descripción Auth Paging

/installation/{UUID}/machinetag GET Machinetag de

l herbario Tapir de SANT

Lista todas las etiquetas máq. NO NO

/installation/{UUID}/machinetag POST ID Crea y añade un nueva

etiqueta. SI NO

/installation/{UUID}/machinetag/{ID} DELETE Borra la etiqueta. SI NO

SISTEMA DE REGISTRO

Page 26: Application Programming  Interface

URL Método Respuesta Descripción Auth Paging

/installation/{UUID}/comment

GET Comentarios de la instalación de GBIF Francia

Lista los comentarios sobre la instalación. NO NO

/installation/{UUID}/comment

POST IDCrea y añade un nuevo comentario asociado a la instalación.

SI NO

/installation/{UUID}/comment/{ID}

DELETE Borra un comentario. SI NO

SISTEMA DE REGISTRO

INSTALACIONES + COMENTARIOS

Page 28: Application Programming  Interface

APPLICATION PROGRAMMING INTERFACE(API)

SISTEMA DE REGISTRO - ORGANIZACIONES

Page 29: Application Programming  Interface

URL Método Respuesta Descripción Auth Paging Parámetros

/organization GET Lista todas las organizaciones.

NO SI q, identifier, identifierType

/organization POST UUID Crea una nueva organización. SI NO

/organization/{UUID} GET Información

de la Universidad de León ,LEB.

Devuelve información sobre la organización.

NO NO

/organization/{UUID} PUT

Actualiza información de la organización.

SI NO

/organization/{UUID} DELETE Borra la

organización. SI NO

ORGANIZACIONES

SISTEMA DE REGISTRO

Page 30: Application Programming  Interface

URL Método Respuesta Descripción Auth Paging

/organization/{UUID}/contact GET Contactos

del Herbario de UNEX

Lista los contactos de la organización. NO NO

/organization/{UUID}/contact POST ID Crea y añade un

nuevo contacto. SI NO

/organization/{UUID}/contact/{ID} PUT Actualiza el

contacto. SI NO

/organization/{UUID}/contact/{ID} DELETE Borra el contacto SI NO

ORGANIZACIONES + CONTACTOS

SISTEMA DE REGISTRO

Page 31: Application Programming  Interface

URL Método Respuesta Descripción Auth Paging

/organization/{UUID}/endpoint

GET Endpoints del Instituto de la Universidad de Alicante.

Lista los puntos de acceso de la organización.

NO NO

/organization/{UUID}/endpoint

POST IDCrea y añade un nuevo punto de acceso a la organización.

SI NO

/organization/{UUID}/endpoint/{ID}

DELETEBorra un punto de acceso de la organización.

SI NO

ORGANIZACIONES + ENDPOINTS

SISTEMA DE REGISTRO

Page 32: Application Programming  Interface

URL Método Respuesta Descripción Auth Paging

/organization/{UUID}/identifier GET Identificadores de

l CIBIO

Lista los identificadores de la organización.

NO NO

/organization/{UUID}/identifier POST ID

Crea y añade un nuevo identificador a la organización.

SI NO

/organization/{UUID}/identifier/{ID}

DELETE Borra un identificador de la organización. SI NO

SISTEMA DE REGISTRO

ORGANIZACIONES + IDENTIFICADORES

Page 33: Application Programming  Interface

URL Método Respuesta Descripción Auth Paging

/organization/{UUID}/tag GET Tags

del Jardín Botánico de Barcelona

Lista todas las etiquetas de la Org. NO NO

/organization/{UUID}/tag POST ID Crea y añade un

nueva etiqueta. SI NO

/organization/{UUID}/tag/{ID} DELETE Borra la etiqueta. SI NO

ORGANIZACIONES + ( TAGS / MACHINE TAGS)

URL Método Respuesta Descripción Auth Paging

/organization/{UUID}/machinetag GET Machinetags Lista todas las

etiquetas máq. NO NO

/organization/{UUID}/machinetag POST ID Crea y añade un

nueva etiqueta. SI NO

/organization/{UUID}/machinetag/{ID}

DELETE Borra la etiqueta. SI NO

SISTEMA DE REGISTRO

Page 34: Application Programming  Interface

URL Método Respuesta Descripción Auth Paging

/organization/{UUID}/comment

GETComentarios sobre Universidad de Córdoba

Lista los comentarios sobre la organización. NO NO

/organization/{UUID}/comment

POST IDCrea y añade un nuevo comentario asociado a la organización.

SI NO

/organization/{UUID}/comment/{ID}

DELETE Borra un comentario. SI NO

SISTEMA DE REGISTRO

ORGANIZACIONES + COMENTARIOS

Page 35: Application Programming  Interface

URL Método Respuesta Descripción Auth Paging

/organization/{UUID}/hostedDataset

GET Dataset alojados en GBIF.es

Lista todos los dataset alojados en la organización. NO SI

/organization/{UUID}/ownedDataset

GET Dataset pertenecientes a la Universidad de Oviedo

Lista todos los dataset publicados por la organización.

NO SI

/organization/{UUID}/installation

GET Instalaciones de GBIF

.es

Lista las instalaciones de la organización NO SI

/organization/deleted GET Lista todas

las organizaciones marcadas como borradas.

NO SI

/organization/nonPublishing GET Lista todas las organizaciones

que sirven 0 dataset NO SI

/organization/pending

Lista las organizaciones que están pendientes de asociac.

NO SI

SISTEMA DE REGISTRO

ORGANIZACIONES

Page 36: Application Programming  Interface

APPLICATION PROGRAMMING INTERFACE(API)

SISTEMA DE REGISTRO - NODOS

Page 37: Application Programming  Interface

URL Método Respuesta Descripción Auth Paging Parámetros

/node GET Lista todos los nodos del registro.

NO SI q, identifier, identifierType

/node POST UUID Crea un nuevo nodo. SI NO

/node/{UUID} GET Información del nodo de GBIF.es

Devuelve información sobre el nodo.

NO NO

/node/{UUID} PUTActualiza información del nodo.

SI NO

/node/{UUID} DELETE Borra el nodo. SI NO

/node/{UUID}/organization GET Organizacion

es asociadas a GBIF.es

Lista todas las organizaciones asoc. a el nodo.

NO SI

NODOS

SISTEMA DE REGISTRO

Page 38: Application Programming  Interface

URL Método Respuesta Descripción Auth Paging

/node/{UUID}/contact GET Contactos

de GBIF Portugal

Lista los contactos del nodo. NO NO

/node/{UUID}/contact POST ID Crea y añade un

nuevo contacto. SI NO

/node/{UUID}/contact/{ID} PUT Actualiza el

contacto. SI NO

/node/{UUID}/contact/{ID} DELETE Borra el contacto SI NO

NODOS + CONTACTOS

SISTEMA DE REGISTRO

Page 39: Application Programming  Interface

URL Método Respuesta Descripción Auth Paging

/node/{UUID}/endpoint GET Endpoint d

e GBIF.esLista los puntos de acceso del nodo. NO NO

/node/{UUID}/endpoint POST ID Crea y añade un nuevo punto

de acceso del nodo. SI NO

/node/{UUID}/endpoint/{ID} DELETE Borra un punto de acceso del

nodo. SI NO

NODOS + ENDPOINTS

SISTEMA DE REGISTRO

Page 40: Application Programming  Interface

URL Método Respuesta Descripción Auth Paging

/node/{UUID}/identifier GET Identificadores

de GBIF.esLista los identificadores del nodo. NO NO

/node/{UUID}/identifier POST ID Crea y añade un nuevo

identificador a el nodo. SI NO

/node/{UUID}/identifier/{ID} DELETE Borra un identificador

del nodo. SI NO

SISTEMA DE REGISTRO

NODOS + IDENTIFICADORES

Page 41: Application Programming  Interface

URL Método Respuesta

Descripción Auth Paging

/node/{UUID}/tag GET Tags de GBIF.es

Lista todas las etiquetas del nodo.

NO NO

/node/{UUID}/tag POST ID Crea y añade un nueva etiqueta. SI NO

/node/{UUID}/tag/{ID}

DELETE Borra la etiqueta. SI NO

NODOS + ( TAGS / MACHINE TAGS)

URL Método Respuesta

Descripción Auth Paging

/node/{UUID}/machinetag GET Machineta

gs de GBIF.es

Lista todas las etiquetas máq. NO NO

/node/{UUID}/machinetag POST ID Crea y añade un

nueva etiqueta. SI NO

/node/{UUID}/machinetag/{ID} DELETE Borra la

etiqueta. SI NO

SISTEMA DE REGISTRO

Page 42: Application Programming  Interface

URL Método Respuesta Descripción Auth Paging

/node/{UUID}/comment GET Comentarios s

obre GBIF.es

Lista los comentarios sobre el nodo. NO NO

/node/{UUID}/comment POST ID

Crea y añade un nuevo comentario asociado a ese nodo.

SI NO

/node/{UUID}/comment/{ID} DELETE Borra un comentario. SI NO

SISTEMA DE REGISTRO

NODOS + COMENTARIOS

Page 43: Application Programming  Interface

URL Método Respuesta Descripción Auth Paging

/node/pendingEndorsement GET Lista todas las organizaciones pendie

ntes de afiliación.NO SI

/node/{UUID}/pendingEndorsement GET Organizaciones

pendientes de afiliación a GBIF.es

Lista todas las organizaciones pendientes de asociación a el nodo. NO SI

/node/country GET Lista todos los países miembros de GBIF.

NO NO

/node/activeCountries GET Lista todos los países

con derecho a votos o países participantes. (ISO-CODE)

NO NO

/node/{UUID}/dataset GET Dataset en

GBIF.esLista todos los dataset por organización alojados en ese nodo. NO SI

/node/{UUID}/installation GET Instalaciones

organizaciones de GBIF.es

Lista las instalaciones de las organizaciones asociadas a un nodo. NO SI

SISTEMA DE REGISTRO

NODOS

Page 44: Application Programming  Interface

APPLICATION PROGRAMMING INTERFACE(API)

SISTEMA DE REGISTRO - NETWORKS

Page 45: Application Programming  Interface

URL Método Respuesta Descripción Auth Paging Parámetros

/network GET Lista todas las redes. NO SI q, identifier,

identifierType

/network POST UUID Crea una nueva red. SI NO

/network/{UUID} GET Catalogue of

LifeDevuelve información sobre la red.

NO NO

/network/{UUID} PUT

Actualiza información de la red.

SI NO

/network/{UUID} DELETE Borra la red. SI NO

NETWORKS

SISTEMA DE REGISTRO

Page 46: Application Programming  Interface

URL Método Respuesta Descripción Auth Paging

/network/{UUID}/contact GET Contactos de

HerpNETLista los contactos de la red. NO NO

/network/{UUID}/contact POST ID Crea y añade un

nuevo contacto. SI NO

/network/{UUID}/contact/{ID} PUT Actualiza el

contacto. SI NO

/network/{UUID}/contact/{ID} DELETE Borra el contacto SI NO

NETWORKS + CONTACTOS

SISTEMA DE REGISTRO

Page 47: Application Programming  Interface

URL Método Respuesta Descripción Auth Paging

/network/{UUID}/endpoint GET Dryad Lista los puntos de acceso

de la red. NO NO

/network/{UUID}/endpoint POST ID Crea y añade un nuevo

punto de acceso a la red. SI NO

/network/{UUID}/endpoint/{ID}

DELETE Borra un punto de acceso de la red. SI NO

NETWORKS + ENDPOINTS

SISTEMA DE REGISTRO

Page 48: Application Programming  Interface

URL Método Respuesta Descripción Auth Paging

/network/{UUID}/identifier

GET Identificadores de

VerNet

Lista los identificadores de la red. NO NO

/network/{UUID}/identifier POST ID Crea y añade un nuevo

identificador a la red. SI NO

/network/{UUID}/identifier/{ID}

DELETE Borra un identificador de la red. SI NO

SISTEMA DE REGISTRO

NETWORKS + IDENTIFICADORES

Page 49: Application Programming  Interface

URL Método Respuesta Descripción Auth Paging

/network/{UUID}/tag GET Tags de Catal

ogue of Life

Lista todas las etiquetas de la red. NO NO

/network/{UUID}/tag POST ID Crea y añade un

nueva etiqueta. SI NO

/network/{UUID}/tag/{ID} DELETE Borra la etiqueta. SI NO

NETWORKS + ( TAGS / MACHINE TAGS)

URL Método Respuesta Descripción Auth Paging

/network/{UUID}/machinetag GET Metatags

CoLLista todas las etiquetas máq. NO NO

/network/{UUID}/machinetag POST ID Crea y añade un

nueva etiqueta. SI NO

/network/{UUID}/machinetag/{ID} DELETE Borra la etiqueta. SI NO

SISTEMA DE REGISTRO

Page 50: Application Programming  Interface

URL Método Respuesta Descripción Auth Paging

/network/{UUID}/comment GET Comentarios

sobre KNB

Lista los comentarios sobre la red. NO NO

/network/{UUID}/comment POST ID

Crea y añade un nuevo comentario asociado a la red.

SI NO

/network/{UUID}/comment/{ID}

DELETE Borra un comentario. SI NO

SISTEMA DE REGISTRO

NETWORKS + COMENTARIOS

Page 51: Application Programming  Interface

URL Método Respuesta Descripción Auth Paging

/network/{UUID}/constituents

GET OZCAM Lista los dataset que forman la red. NO SI

/network/{UUID}/constituents

POST ID Crea un nuevo dataset asociado a esa red. SI NO

/network/{UUID}/constituents/{ID}

DELETE Borra un dataset de esa red. SI NO

SISTEMA DE REGISTRO

NETWORKS + DATASET

Page 52: Application Programming  Interface

APPLICATION PROGRAMMING INTERFACE(API)

INFORMACIÓN DE ESPECIES

Page 53: Application Programming  Interface

URL Método Respuesta Descripción Auth Paging Parámetros

/species GET Species listLista todos los nombres de la checklist.

NO SI(Explicación)

language, datasetKey, sourceId, name

/species/{int} GET Acalypha

(*)

Devuelve información sobre la sp.

NO NO

/species/{int}/verbatim

GET Devuelve el verbatim . NO NO

/species/{int}/name GET Acalypha nam

eInformación del nombre. NO NO

NAME USAGE (Introducción)

INFORMACIÓN DE ESPECIES

Page 54: Application Programming  Interface

URL Método Respuesta Descripción Auth Paging Parámetros

/species/{int}/parents GET Padres de Acaly

pha

Lista los padres en la taxonomía.

NO NO language

/species/{int}/children GET Hijos de Acalyph

aLista los hijos de Acalypha. NO SI language

/species/{int}/related GET Relacionados

con Acalypha

Lista los nombres afines de otras checklist.

NO NO language, datasetKey

/species/{int}/synomyms

GET Sinónimos de Orthotrichum gymnostomum

(*)

Devuelve los sinónimos del nombre.

NO NO language,

NAME USAGE

INFORMACIÓN DE ESPECIES

Page 56: Application Programming  Interface

BÚSQUEDA DE NOMBRES

INFORMACIÓN DE ESPECIES

- Nos encontramos con 4 tipos de búsquedas las cuales se distinguen por cómo buscan la información, por el formato que devuelven y por el contenido sobre el cual realizan la búsqueda.

1. Búsqueda simple: Busca un nombres científicos a lo largo de todas las checklist.

2. Búsqueda aproximada: de nombres científicos en el GBIF Backbone Taxonomy, pudiendo especificar la taxonomía.

3. Búsqueda completa: Busca el nombre en varios campos: scientific name, vernacular name, en la descripción de la especie, en la distribución y por toda la clasificación.

4. Búsqueda autocompletada: Buscar los 20 primeros registros cuyo nombre científico coincida.

Page 57: Application Programming  Interface

URL Método Respuesta Descripción Paging Parámetros

/species GET Puma concolor Búsqueda exacta. NO language

/species/match GET Oenante,

Plantae, verbose = true

Búsqueda aproximada. SI

rank, name, strict, verbose (1=muestra los descartados), kingdom, phylum, class, order, family, genus

BÚSQUEDA DE NOMBRES

INFORMACIÓN DE ESPECIES

Page 60: Application Programming  Interface

APPLICATION PROGRAMMING INTERFACE(API)

INFORMACIÓN SOBRE OBSERVACIONES Y

ESPECÍMENES

Page 61: Application Programming  Interface

URL Método Respuesta Descripción Auth Paging Parámetros

/occurrence/{key}

GET Registro de BC-lich

Devuelve los detalles de un registro.

NO NO language

/occurrence/{key}/verbatim

GETVerbatim del un registro de

BC-lich

Devuelve el verbatim de un registro.

NO SI language

OCCURENCES

INFORMACIÓN DE ESPECIMENES Y OBSERVACIONES

Estas API nos proporcionan servicios para obtener información de un registro de forma individual.

NOTA: La key es el GBIF_ID que podemos observar en la ficha del registro.

Page 62: Application Programming  Interface

URL Método Respuesta Descripción Paging Parámetros

/occurrence/search

GET

Occurrence del dataset de la Universidad de Córdoba (

Fungi-COFC)

Busca los registros a través del GBIF occurrence Storage y los ordena por relevancia.

SI

datasetKey, year, month, latitude, longitude, country, publishingCountry, altitude, depth, institutionCode, collectionCode, catalogNumber, collectorName, basisOfRecord, taxonKey, georeferenced, geometry, spatialIssues

BÚSQUEDAS

INFORMACIÓN DE ESPECIMENES Y OBSERVACIONES

Page 63: Application Programming  Interface

URL Método Respuesta Descripción Paging Parámetros

/occurrence/search/catalog_number

GET C.N que contengan GDA

Buscar por número de catálogo.

NO q, limit

/occurrence/search/collection_code GET Código de col

ección = SANT

Busca códigos de colección.

NO q, limit

/occurrence/search/collector_name GET Collector

names = Jacint

Busca nombres de colector.

NO q, limit

/occurrence/search/institution_code GET Instituciones

que contengan MA

Busca las instituciones.

NO q, limit

BÚSQUEDAS

INFORMACIÓN DE ESPECIMENES Y OBSERVACIONES

Page 65: Application Programming  Interface

URL Método Respuesta Descripción Parámetros

/occurrence/counts/ datasets GET Cuenta los registr

os de todos los datasets GBIF.ES

Contabiliza el número de registros por dataset país.

country, nubkey

/occurrence/counts/Countries GET Registros cuyo or

igen es España.

Contabiliza todos registros cuyo país de origen es el escrito.

publishingCountry

/occurrence/counts/publishingCountry GET Agrupa por país

de origen los registros de España.

Cuenta todos los registros publicados en ese país.

country

INVENTARIO

INFORMACIÓN DE ESPECIMENES Y OBSERVACIONES

Page 66: Application Programming  Interface

APPLICATION PROGRAMMING INTERFACE(API)

MAPAS

Page 67: Application Programming  Interface

WEB MAP TILE SERVICE: FORMATO

MAPAS

http://api.gbif.org/v0.9/map/density/tile?x={x}&y={y}&z={z}

Parámetros:⁻ type – oligatorio – TAXON, DATASET,COUNTRY,PUBLISHER⁻ key – obligatorio – taxon_key,uuid del dataset/publisher o el ISO country code.⁻ resolution – opcional (por defecto =1, {1,2,4,..,16}) Densidad⁻ layer - opcional – Nos permite definir las capas de información que queramos

que sean visualizadas.⁻ palette – opcional – Permite seleccionar el juego de colores con el cual

queremos que se coloreen las cantidades de datos mostrados.⁻ saturation & hue: Cuando saturation=true, el hue puede tomar un valor entre 0

y 1.

Page 68: Application Programming  Interface

WEB MAP TILE SERVICE

MAPAS

Esta api nos permite visualizar contenido de GBIF en mapas interactivos.

Características soportadas:

1. Capas para country, dataset, taxon (species, subspecies o higer taxon), publisher.

2. Permite personalizar el color o definir un propio estilo en el cual se muestras los datos.

3. Permite filtrar los contenidos mostrados por Basis of Record. Ej: Specimens, Observations, Fossils etc.

4. Dependiendo del tipo de Basis of record se puede especificar el periodo por décadas. Ej: Un mapa que nos muestre todas las observaciones de una especie desde 1970.

NOTA: se puede usar con la api de googel maps, con la librería de leaflet JS o con simples mapas en JS. Estas liberías permiten la visualización de las capas de datos sobre la capa geográficas

Page 69: Application Programming  Interface

CASOS PRÁCTICOS:

MAPAS

1. Mapa de observaciones y especímenes.http://www.gbif.es/occurrenceMap.html

2. Mapa con Filtrados.http://www.gbif.es/Map.html

Page 70: Application Programming  Interface

APPLICATION PROGRAMMING INTERFACE(API)

ANEXO