Code snippet to access a REST API and request JSON data

Abstract

This code snippet accesses an external REST API, and thus request JSON data and return parsed JSON data through a Groovy script written in the Groovy editor of the add-on.

Logic

• Import the HTTPBuilder and the request methods.
• Access the REST API by creating a new HTTP instance.
• Request the JSON data passing the method, the content type, and the request configuration closure to the request method.
• Return the parsed JSON data from the response.

Snippet 

import groovyx.net.http.HTTPBuilder
import static groovyx.net.http.Method.<methodName>
import static groovyx.net.http.ContentType.<contentType>
 
// initialize a new builder and give a default URL
def http = new HTTPBuilder("<URL>")
 
http.request(<methodName>,<contentType>) { req ->
 
  response.success = { resp, reader ->
    assert resp.status == 200
	return reader
  }
 
  // called only for a 404 (not found) status code:
  response."404" = { resp ->
    log.error ("Not found")
  }
}

Placeholders

Context

The outcome of the code snippet depends on the content type passed to the request method. You could use this code, for example, to get a specific currency conversion rate.

Use cases

• /wiki/spaces/IN/pages/447381518

Reference

• HTTPBuilder
• Groovy Documentation

Related articles