Blackout Dates (Category 11) Rules Web Service

Blackout Dates (Category 11) Rules API is used to specify a date or range of dates when travel is not permitted. The API is designed by ATPCO to meet your needs for automated table creation so you can reduce manual input and get your fares to market faster.

Request

Your request to the Blackout Dates (Category 11) Rules Web Service must provide a valid OAuth Access Token and a userId in the header. For instructions on how to obtain and use an OAuth Access Token programmatically, see OAuth Access Tokens and Authentication. You must also specify parameters in the request body.

Request Header Parameters

See OAuth Access Tokens and Authentication for instructions on header parameters needed for authentication.

Request Body

The request body should be formatted as a JSON object (examples below).

Request Object Parameters

All data requests must be received in the JSON format specified by ATPCO, with field names and sub values found in Data Application unless otherwise specified (fields and sub values (i.e., parameters) detailed below). Field names and provided values must be enclosed in quotation marks (e.g., "tvlDtExp").

• "" or " " as a field name or field value: an empty or non-empty blank string within quotation marks in the request is ignored and will not appear in the JSON response
• Invalid field names in a request are ignored
• Invalid field values in a request generate an error

If your request contains field names that are invalid in a request yet valid in a response (e.g., msgs or msg), those fields will be eliminated during processing and overlaid when necessary in the response.

All String fields (enclosed in double quotes) will have leading and trailing spaces removed unless removing all blanks would violate a possible value for a field where blank(s) is valid on a JSON request. Some fields may have special leading/trailing blanks removal rules such as NoteText996, where only trailing blanks are removed to preserve any intentional text indentations.

Examples of Invalid Field names and values

The request object can include any of the following parameters:

Category 11 Parameters

994 Override Date Fields

996 Note Text

995 Between Geographic Specification Fields

995 And Geographic Specification Fields

General Fields

Response

Responses from the Blackout Dates (Category 11) Rules Web Service use the same parameters as requests, outlined above. Responses can also include msg and msgs, which are used to communicate error messages.

Example Requests and Responses

Simple Category Request

(display only table numbers in response)

{
  "rtnTblNumsOnly":"Y",

  "blkOutDts11": {
    "dtRangeAppl": "R",
    "startDt": "20180930",
	"stopDt": "20181030"
	
  }
}

{
  "rtnTblNumsOnly": "Y",
  "blkOutDts11": {
    "tblNum": "4035046"
  }
}

Simple Category Request with Supporting Table 994

(display table numbers and values in response)

{
  "rtnTblNumsOnly":"N",

  "blkOutDts11": {
    "dtRangeAppl": "D", 
    "startDt": "20180930",
	"stopDt": "20181030",
    "ovrrdDt994": {
      "rsvEff": "20180101"
    }
  }
}

{
  "rtnTblNumsOnly": "N",
  "blkOutDts11": {
    "dtRangeAppl": "D",
    "tblNum": "4034902",
    "startDt": "20180930",
	"stopDt": "20181030",
    "ovrrdDt994": {
      "tblNum": "58696",
      "rsvEff": "20180101"
    }
  }
}

Full Category Request

(display only table numbers in response)

{
  "rtnTblNumsOnly":"Y",


  "blkOutDts11": {
    "dtRangeAppl": "D", 
    "startDt": "20180201",
    "stopDt": "20181030",
    "waiveIntlConn": "X",
     "ovrrdDt994": {
      "rsvEff": "20180101",
      "rsvDisc": "20180731",  
      "tktDisc": "20180731",
      "tvlEff": "20180201",
      "tvlDisc": "20181030"
    },
    "noteTxt996": {
      "txtLns": [{"lnNum":"1","txt": "THIS IS SAMPLE NOTE TEXT TO ILLUSTRATE"}
                ,{"lnNum":"2","txt": "          INDENTATION AND LINE BREAKS"}
                ,{"lnNum":"3","txt": "                IN YOUR REQUEST AND RESPONSE."}
                ,{"lnNum":"4","txt": "WE HOPE THAT YOU ARE ENJOYING OUR DEMO.."}]
    },
      "btwGeoSpec995": {
      "loc1": "SEA",
      "type": "C",
      "loc2": "NYC",
      "tsi": "01"
    } "andGeoSpec995": {
      "loc1": "SEA",
      "type": "C",
      "loc2": "MIA",
      "tsi": "01"
    }
  }
}

{
  "rtnTblNumsOnly": "Y",

  "blkOutDts11": {
    "tblNum": "4035073",
    "ovrrdDt994": {
      "tblNum": "58746"
    },
    "andGeoSpec995": {
      "tblNum": "274619"
    },
	"betweenGeoSpec995": {
      "tblNum": "284619"
    },
    "noteTxt996": {
      "tblNum": "8187666"
    }
  }
}

Simple Category Request Using Data and Existing Table Number

(display table number and values in response)

{
  "rtnTblNumsOnly":"N",
  "blkOutDts11": {
    "dtRangeAppl": "D",
    "startDt": "20180930",
	"stopDt": "20181030",
    "ovrrdDt994": {
      "tblNum": "12345678",
    }
  }
}

{
  "rtnTblNumsOnly": "N",
  "blkOutDts11": {
    "tblNum": "4034902",
	"dtRangeAppl": "D",
    "startDt": "20180930",
	"stopDt": "20181030",
    "ovrrdDt994": {
      "tblNum": "12345678",
		
    }
  }
}