Class: GdsApi::ContentApi

Inherits:
Base
  • Object
show all
Includes:
ExceptionHandling
Defined in:
lib/gds_api/content_api.rb

Instance Attribute Summary

Attributes inherited from Base

#options

Instance Method Summary collapse

Methods included from ExceptionHandling

#ignoring

Methods inherited from Base

#adapter_name, #client, #create_client, #initialize, #url_for_slug

Constructor Details

This class inherits a constructor from GdsApi::Base

Instance Method Details

#artefact(slug, params = {}) ⇒ Object 



35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
 
# File 'lib/gds_api/content_api.rb', line 35

def artefact(slug, params={})
  edition = params[:edition]
  snac = params[:snac]

  url = "#{base_url}/#{slug}.json"
  query = params.map { |k,v| "#{k}=#{v}" }
  if query.any?
    url += "?#{query.join("&")}"
  end

  if edition && ! options.include?(:bearer_token)
    raise GdsApi::NoBearerToken
  end
  get_json(url)
end

#business_support_schemes(identifiers) ⇒ Object 



68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
 
# File 'lib/gds_api/content_api.rb', line 68

def business_support_schemes(identifiers)
  identifiers = identifiers.map {|i| CGI.escape(i) }
  url_template = "#{base_url}/business_support_schemes.json?identifiers="
  response = nil # assignment necessary for variable scoping

  start_url = "#{url_template}#{identifiers.shift}"
  last_batch_url = identifiers.inject(start_url) do |url, id|
    new_url = [url, id].join(',')
    if new_url.length >= 2000
      # fetch a batch using the previous url, then return a new start URL with this id
      response = get_batch(url, response)
      "#{url_template}#{id}"
    else
      new_url
    end
  end
  get_batch(last_batch_url, response)
end

#curated_list(tag) ⇒ Object 



27
28
29
 
# File 'lib/gds_api/content_api.rb', line 27

def curated_list(tag)
  get_json("#{base_url}/with_tag.json?tag=#{CGI.escape(tag)}&sort=curated")
end

#licences_for_ids(ids) ⇒ Object 



63
64
65
66
 
# File 'lib/gds_api/content_api.rb', line 63

def licences_for_ids(ids)
  ids = ids.map(&:to_s).sort.join(',')
  get_json("#{@endpoint}/licences.json?ids=#{ids}")
end

#local_authorities_by_name(name) ⇒ Object 



55
56
57
 
# File 'lib/gds_api/content_api.rb', line 55

def local_authorities_by_name(name)
  get_json!("#{base_url}/local_authorities.json?name=#{CGI.escape(name)}")
end

#local_authorities_by_snac_code(snac_code) ⇒ Object 



59
60
61
 
# File 'lib/gds_api/content_api.rb', line 59

def local_authorities_by_snac_code(snac_code)
  get_json!("#{base_url}/local_authorities.json?snac_code=#{CGI.escape(snac_code)}")
end

#local_authority(snac_code) ⇒ Object 



51
52
53
 
# File 'lib/gds_api/content_api.rb', line 51

def local_authority(snac_code)
  get_json("#{base_url}/local_authorities/#{CGI.escape(snac_code)}.json")
end

#root_sections ⇒ Object 



11
12
13
 
# File 'lib/gds_api/content_api.rb', line 11

def root_sections
  get_json!("#{base_url}/tags.json?type=section&root_sections=true")
end

#sections ⇒ Object 



7
8
9
 
# File 'lib/gds_api/content_api.rb', line 7

def sections
  get_json!("#{base_url}/tags.json?type=section")
end

#sorted_by(tag, sort_by) ⇒ Object 



31
32
33
 
# File 'lib/gds_api/content_api.rb', line 31

def sorted_by(tag, sort_by)
  get_json!("#{base_url}/with_tag.json?tag=#{CGI.escape(tag)}&sort=#{sort_by}")
end

#sub_sections(parent_tag) ⇒ Object 



15
16
17
 
# File 'lib/gds_api/content_api.rb', line 15

def sub_sections(parent_tag)
  get_json!("#{base_url}/tags.json?type=section&parent_id=#{CGI.escape(parent_tag)}")
end

#tag(tag) ⇒ Object 



19
20
21
 
# File 'lib/gds_api/content_api.rb', line 19

def tag(tag)
  get_json("#{base_url}/tags/#{CGI.escape(tag)}.json")
end

#with_tag(tag) ⇒ Object 



23
24
25
 
# File 'lib/gds_api/content_api.rb', line 23

def with_tag(tag)
  get_json!("#{base_url}/with_tag.json?tag=#{CGI.escape(tag)}&include_children=1")
end