Tracking API specification

###Deployment tracking request To record an application deployment:

• POST /api/v1/track

• Parameters:

  Parameter	Value	Parameter Type	Description	Data Type
  Content-Type	application/json	header	Must be application/json	string
  Body	JSON, see details below	body	Tracking payload	string

  Body Model:

  {
    application_name: string, 
    application_uris: string,
    application_version: string, 
    bound_vcap_services: string,
    code_version: string,        
    date_sent: dateTime,         
    repository_url: string,
    runtime: string,
    space_id: string
  }
  

  • application_name: Cloud Foundry Environment variable VCAP_APPLICATION attribute application_name
  • application_uris: Cloud Foundry Environment variable VCAP_APPLICATION attribute application_uris
  • application_version: Cloud Foundry Environment variable VCAP_APPLICATION attribute application_version
  • bound_vcap_services:
  • code_version: Sample application code version
  • date_sent: ISO 8601 formatted date/time (e.g. 1985-04-12T23:20:50.52Z)
  • repository_url: [GitHub] repository URL of the sample application (e.g. https://github.com/ibm-cds-labs/simple-data-pipe.git)
  • runtime: one of nodejs, java, python,go, swift
  • space_id: Cloud Foundry Environment variable VCAP_APPLICATION attribute space_id

An example is listed at the bottom of this page.

• Responses:

  Response codes:

  HTTP status code	Reason	Response body
  201	success	{"ok":true}
  400	body of tracking request is empty
  500	server-side error

  Response headers:

   {
    "Content-Type": "application/json"
   }
  

Example:

POST https://deployment-tracker.mybluemix.net/api/v1/track

  {
    application_name: "my-simple-data-pipe", 
    application_uris: ["my-simple-data-pipe.mybluemix.net"],
    application_version: "5bbcb651-0ca4-4b67-b710-c327cd040257", 
    bound_vcap_services: string,
    code_version: "0.1.0",        
    date_sent: "2016-08-02T20:59:00.153Z",         
    repository_url: "https://github.com/ibm-cds-labs/simple-data-pipe",
    runtime: "nodejs",
    space_id: "9b275cb0-9249-4c36-437a-3ef8682d3523"
  }