Skip to content

cichockimc/api-subscription-fields

BranchesTags
 
 

Repository files navigation

API Subscription Fields

Build Status Download

This microservice stores definitions and values relating to API subscriptions for the HMRC Developer Hub.

Endpoints Summary

Path Method Description
/definition/context/:apiContext/version/:apiVersion PUT Creates or updates the definitions of the subscriptions fields for an API
/definition/context/:apiContext/version/:apiVersion GET Retrieves the definitions of subscription fields for an API
/definition GET Retrieves the definitions of subscription fields for all APIs
/definition/context/:apiContext/version/:apiVersion DELETE Deletes the definitions of all subscriptions fields for an API
/field/application/:clientId/context/:apiContext/version/:apiVersion PUT Creates or updates the field values of an API subscription
/field/application/:clientId/context/:apiContext/version/:apiVersion GET Retrieves the field values of an API subscription by providing the application and API details
/field/:fieldsId GET Retrieves the field values of an API subscription by providing the fieldsId
/field/application/:clientId GET Retrieves the field values of all API subscriptions related to a specific application
/field GET Retrieves the field values of all API subscriptions
/field/application/:clientId/context/:apiContext/version/:apiVersion DELETE Deletes the field values of an API subscription

PUT Field Definitions

PUT /definition/context/:apiContext/version/:apiVersion

Creates or updates the definitions of the subscriptions fields for an API

Response with

Status Description
201 Created
200 Updated

example

curl command
curl -v -X PUT "http://localhost:9650/definition/context/hello/version/1.0" -H "Cache-Control: no-cache" -H "Content-Type: application/json" -d '{ "fieldDefinitions": [ { "name": "callback-url", "description": "Callback URL", "hint": "Callback URL Hint", "type": "URL" }, { "name": "token", "description": "Secure Token", "hint": "Secure Token Hint", "type": "SecureToken" } ] }'
Request body
{
  "fieldDefinitions": [
    {
      "name": "callback-url",
      "description": "Callback URL",
      "hint": "Callback URL Hint",
      "type": "URL"
    },
    {
      "name": "token",
      "description": "Secure Token",
      "hint": "Secure Token Hint",
      "type": "SecureToken"
    }
  ]
}
Response body
{
  "apiContext": "hello",
  "apiVersion": "1.0",
  "fieldDefinitions": [
    {
      "name": "callback-url",
      "description": "Callback URL",
      "hint": "Callback URL Hint",
      "type": "URL"
    },
    {
      "name": "token",
      "description": "Secure Token",
      "hint": "Secure Token Hint",
      "type": "SecureToken"
    }
  ]
}

GET Field Definitions for an API

GET /definition/context/:apiContext/version/:apiVersion

Retrieves the definitions of subscription fields for an API

Response with

Status Description
200 Updated
404 Not found

example

curl command
curl -v -X GET "http://localhost:9650/definition/context/hello/version/1.0" -H "Cache-Control: no-cache"
Request body

None

Response body
{
  "apiContext": "hello",
  "apiVersion": "1.0",
  "fieldDefinitions": [
    {
      "name": "callback-url",
      "description": "Callback URL",
      "hint": "Callback URL Hint",
      "type": "URL"
    },
    {
      "name": "token",
      "description": "Secure Token",
      "hint": "Secure Token Hint",
      "type": "SecureToken"
    }
  ]
}

GET Field Definitions For All APIs

/definition

Retrieves the definitions of subscription fields for all APIs

Response with

Status Description
200 OK

example

curl command
curl -v -X GET "http://localhost:9650/definition" -H "Cache-Control: no-cache"
Request body

None

Response body
{
  "apis": [
    {
      "apiContext": "hello",
      "apiVersion": "1.0",
      "fieldDefinitions": [
        {
          "name": "callback-url",
          "description": "Callback URL",
          "hint": "Callback URL Hint",
          "type": "URL"
        },
        {
          "name": "token",
          "description": "Secure Token",
          "hint": "Secure Token Hint",
          "type": "SecureToken"
        }
      ]
    },
    {
      "apiContext": "ciao",
      "apiVersion": "2.0",
      "fieldDefinitions": [
        {
          "name": "address",
          "description": "where you live",
          "hint": "where you live hint",
          "type": "STRING"
        },
        {
          "name": "number",
          "description": "telephone number",
          "hint": "telephone number hint",
          "type": "STRING"
        }
      ]
    }
  ]
}

DELETE Field Definitions

DELETE /definition/context/:apiContext/version/:apiVersion

Deletes the definitions of all subscriptions fields for an API

Response with

Status Description
204 Deleted
404 Not found

example

curl command
curl -v -X DELETE "http://localhost:9650/definition/context/hello/version/1.0" -H "Cache-Control: no-cache"
Request body

None

Response body

None

PUT Field Values

PUT /field/application/:clientId/context/:apiContext/version/:apiVersion

Creates or updates the field values of an API subscription

Response with

Status Description
201 Created
200 Updated

example

curl command
curl -v -X PUT "http://localhost:9650/field/application/hBnFo14C0y4SckYUbcoL2PbFA40a/context/hello/version/1.0" -H "Cache-Control: no-cache" -H "Content-Type: application/json" -d '{ "fields" : { "callback-url" : "http://localhost:8080/callback", "token" : "abc59609za2q" } }'
Request body
{
  "fields": {
    "callback-url": "http://localhost:8080/callback",
    "token": "abc59609za2q"
  }
}
Response body
{
  "clientId": "hBnFo14C0y4SckYUbcoL2PbFA40a",
  "apiContext": "hello",
  "apiVersion": "1.0",
  "fieldsId": "55c2b945-1c82-4749-b4fc-42e5u32192ew", 
  "fields": {
    "callback-url": "http://localhost:8080/callback",
    "token": "abc59609za2q"
  }
}

GET Field Values by application and API

GET /field/application/:clientId/context/:apiContext/version/:apiVersion

Retrieves the field values of an API subscription by providing the application and API details

Response with

Status Description
200 OK
404 Not found

example

curl command
curl -v -X GET "http://localhost:9650/field/application/hBnFo14C0y4SckYUbcoL2PbFA40a/context/hello/version/1.0" -H "Cache-Control: no-cache"
Request body

None

Response body
{
  "clientId": "hBnFo14C0y4SckYUbcoL2PbFA40a",
  "apiContext": "hello",
  "apiVersion": "1.0",
  "fieldsId": "55c2b945-1c82-4749-b4fc-42e5u32192ew", 
  "fields": {
    "callback-url": "http://localhost:8080/callback",
    "token": "abc59609za2q"
  }
}

GET Field Values by fieldsId

GET /field/application/:fieldsId

Retrieves the field values by providing the fieldsId

Response with

Status Description
200 OK
404 Not found

example

curl command
curl -v -X GET "http://localhost:9650/field/55c2b945-1c82-4749-b4fc-42e5u32192ew" -H "Cache-Control: no-cache"
Request body

None

Response body
{
  "clientId": "xp5036mSZooNOlD0Nfjz7LKnCy0a",
  "apiContext": "hello",
  "apiVersion": "1.0",
  "fieldsId": "55c2b945-1c82-4749-b4fc-42e5u32192ew", 
  "fields": {
    "callback-url": "http://localhost:8080/callback",
    "token": "abc59609za2q"
  }
}

GET Field Values by application

GET /field/application/:clientId

Retrieves the field values of all API subscriptions related to a specific application

Response with

Status Description
200 OK
404 Not found

example

curl command
curl -v -X GET "http://localhost:9650/field/application/xp5036mSZooNOlD0Nfjz7LKnCy0a" -H "Cache-Control: no-cache"
Request body

None

Response body
{
  "subscriptions": [
    {
      "clientId": "xp5036mSZooNOlD0Nfjz7LKnCy0a",
      "apiContext": "hello",
      "apiVersion": "1.0",
      "fieldsId": "55c2b945-1c82-4749-b4fc-42e5u32192ew",
      "fields": {
        "callback-url": "http://localhost:8080/callback",
        "token": "abc59609za2q"
      }
    },
    {
      "clientId": "xp5036mSZooNOlD0Nfjz7LKnCy0a",
      "apiContext": "callme",
      "apiVersion": "2.0",
      "fieldsId": "66c2b945-1c82-4749-b4fc-42e5u39999ew",
      "fields": {
        "callback-url": "http://localhost:8081/callback",
        "token": "def45609za2p"
      }
    }
  ]
}

GET All Field Values

GET /field

Retrieves the field values of all API subscriptions

Response with

Status Description
200 OK

example

curl command
curl -v -X GET "http://localhost:9650/field" -H "Cache-Control: no-cache"
Request body

None

Response body
{
  "subscriptions": [
    {
      "clientId": "xp5036mSZooNOlD0Nfjz7LKnCy0a",
      "apiContext": "hello",
      "apiVersion": "1.0",
      "fieldsId": "55c2b945-1c82-4749-b4fc-42e5u32192ew",
      "fields": {
        "callback-url": "http://localhost:8080/callback",
        "token": "abc59609za2q"
      }
    },
    {
      "clientId": "ab4536mPZooNOlD0Nfjz7LKuJy0b",
      "apiContext": "callme",
      "apiVersion": "2.0",
      "fieldsId": "66c2b945-1c82-4749-b4fc-42e5u39999ew",
      "fields": {
        "callback-url": "http://localhost:8081/callback",
        "token": "def45609za2p"
      }
    }
  ]
}

DELETE Field Values

DELETE /field/application/:clientId/context/:apiContext/version/:apiVersion

Deletes the field values of an API subscription

Response with

Status Description
204 Deleted
404 Not found

example

curl command
curl -v -X DELETE "http://localhost:9650/field/application/hBnFo14C0y4SckYUbcoL2PbFA40a/context/hello/version/1.0" -H "Cache-Control: no-cache"
Request body

None

Response body

None

Tests

Some tests require MongoDB to run. Thus, remember to start up MongoDB if you want to run the tests locally. There are unit tests, integration tests, acceptance tests and code coverage reports. In order to run them, use this command line:

./run_all_tests.sh

License

This code is open source software licensed under the Apache 2.0 License

About

No description, website, or topics provided.

Resources

Readme

License

Apache-2.0 license
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

22 tags

Packages

No packages published

Languages

  • Scala 99.9%
  • Shell 0.1%