El Projecte | Sobre nosaltres | Contribuir | Donacions | Llicència
HOME Els meus cursos Finalitzats
◄ Anterior
◄

APIs i Serveis Web

Següent ►
►

En aquest mòdul, aprendrem com interactuar amb APIs i serveis web utilitzant MUMPS. Les APIs (Application Programming Interfaces) permeten que diferents aplicacions es comuniquin entre elles, mentre que els serveis web són una forma específica d'API que utilitza protocols web per a la comunicació.

Objectius del Mòdul

  • Entendre què són les APIs i els serveis web.
  • Aprendre a consumir APIs des de MUMPS.
  • Crear un servei web senzill utilitzant MUMPS.

Què és una API?

Una API és un conjunt de regles que permeten que una aplicació accedeixi a les funcionalitats d'una altra aplicació. Les APIs defineixen com les sol·licituds i respostes han de ser estructurades, permetent la comunicació entre diferents sistemes.

Tipus d'APIs

  • APIs RESTful: Utilitzen el protocol HTTP i operacions com GET, POST, PUT, DELETE.
  • APIs SOAP: Utilitzen el protocol SOAP (Simple Object Access Protocol) i són més estructurades i segures.

Consumir APIs des de MUMPS

Exemple: Consumir una API RESTful

Suposem que volem consumir una API que retorna informació meteorològica. Utilitzarem una API pública com OpenWeatherMap.

Pas 1: Configuració de l'Entorn

Assegura't de tenir accés a una biblioteca HTTP per a MUMPS. Una opció és utilitzar %Net.HttpRequest si estàs treballant amb InterSystems Caché.

Pas 2: Escriure el Codi

GETWEATHER(city)
    NEW request, response, apiKey, url
    SET apiKey = "la_teva_clau_api"
    SET url = "http://api.openweathermap.org/data/2.5/weather?q="_city_"&appid="_apiKey

    SET request = ##class(%Net.HttpRequest).%New()
    SET request.Server = "api.openweathermap.org"
    SET request.SSLConfiguration = "SSL"
    SET request.Https = 1
    SET request.ContentType = "application/json"
    SET request.Timeout = 30

    DO request.Get(url)
    SET response = request.HttpResponse.Data.Read()
    WRITE response
    QUIT

Explicació del Codi

  1. Definició de Variables: Definim les variables request, response, apiKey i url.
  2. Construcció de la URL: Construïm la URL amb la ciutat i la clau API.
  3. Creació de l'Objecte HttpRequest: Utilitzem la classe %Net.HttpRequest per crear una sol·licitud HTTP.
  4. Configuració de la Sol·licitud: Configurem el servidor, SSL, tipus de contingut i temps d'espera.
  5. Enviament de la Sol·licitud: Utilitzem el mètode Get per enviar la sol·licitud.
  6. Lectura de la Resposta: Llegim la resposta i la mostrem.

Exercici Pràctic

Objectiu: Escriu una funció en MUMPS que consumeixi una API pública de la teva elecció i mostri la resposta.

Solució Proposada:

GETJOKE()
    NEW request, response, url
    SET url = "https://official-joke-api.appspot.com/random_joke"

    SET request = ##class(%Net.HttpRequest).%New()
    SET request.Server = "official-joke-api.appspot.com"
    SET request.Https = 1
    SET request.ContentType = "application/json"
    SET request.Timeout = 30

    DO request.Get(url)
    SET response = request.HttpResponse.Data.Read()
    WRITE response
    QUIT

Crear un Servei Web en MUMPS

Exemple: Crear un Servei Web Senzill

Suposem que volem crear un servei web que retorna un missatge de benvinguda.

Pas 1: Definir el Servei Web

WELCOME(name)
    NEW response
    SET response = "Benvingut, "_name_"!"
    QUIT response

Pas 2: Configurar el Servei Web

Utilitzarem una configuració específica del servidor web per exposar aquesta funció com un servei web. Això pot variar segons la plataforma MUMPS que utilitzis.

Exercici Pràctic

Objectiu: Escriu una funció en MUMPS que accepti un nom com a paràmetre i retorni un missatge de benvinguda. Configura aquesta funció com un servei web.

Solució Proposada:

WELCOME(name)
    NEW response
    SET response = "Benvingut, "_name_"!"
    QUIT response

Resum

En aquest mòdul, hem après:

  • Què són les APIs i els serveis web.
  • Com consumir una API RESTful des de MUMPS.
  • Com crear un servei web senzill en MUMPS.

Aquestes habilitats són fonamentals per integrar aplicacions MUMPS amb altres sistemes i serveis, ampliant així les seves capacitats i funcionalitats.

◄ Anterior
◄
Següent ►
►
El Projecte | Sobre nosaltres | Contribuir | Donacions | Llicència
© Copyright 2024. Tots els drets reservats