The update service is used to synchronize on-site installations of CLAIMS Direct. This service is used directly by apgupd.

/check

Check the availability of updates.

MethodGET
Path/update/check
Parameter
ValuesDescription

@max_client_modified_load_idinteger: e.g., 251234The maximum modified_load_id in the table xml.t_patent_document_values of the on-site PostgreSQL database

@limitinteger: e.g., 10Number of load structures to return. Default: 10

Example

Request

wget -O- -q \ 
--header 'x-user:x' \
--header 'x-password:y' \
'https://cdws21.ificlaims.com/update/check?max_client_modified_load_id=260221&limit=1'

Response

{
   "status" : "success",
   "time" : "0.112",
   "load_info" : {
      "start_load_id" : 260222,
      "earliest" : "2017-03-22 22:13:03.325308",
      "end_load_id" : 260247,
      "nloads" : "19",
      "latest" : "2017-03-23 05:10:34.620999",
      "loads" : [
         {
            "session_id" : "000000260222-IFI-Cont",
            "load_source" : "IFI-Cont",
            "completed_stamp" : "2017-03-22 22:13:03.325308",
            "load_id" : 260222,
            "running_status" : "complete",
            "entered_stamp" : "2017-03-22 22:12:59.04867",
            "completed_status" : "success",
            "client_extract_process_id" : 121592,
            "url" : "https://alexandria.fairviewresearch.com/dwh/20170322/000000260222-IFI-Cont.tar.gz",
            "ndocs" : 1,
            "server_name" : "adbbr02"
         }
      ]
   }
}

Details

JSON MemberDescription
statusRequest status (success | failed)
timeTime, in seconds, to complete the request
load_infoStructure representing pending load information
.start_load_idThe next load id available to be processed
.end_load_idThe last load id available to be processed
.earliestTimestamp of earliest available load. This is the timestamp that the load was processed on the CLAIMS Direct primary platform.
.latestTimestamp of latest available load. This is the timestamp that the load was processed on the CLAIMS Direct primary platform.
.nloadsNumber of pending loads. This number may not be the same as end_load_id - start_load_id as not all load id(s) are applicable to every subscription level.
.loads

An array of load structures consisting of:

JSON MemberDescription
load_sourceThe load source for this load id. See the load sources documentation for details.
load_idThe load identifier
ndocsNumber of documents contained in this load
urlThe URL of the package to download (HTTP Basic Authentication)
entered_stampInternal
running_statusInternal
completed_stampInternal
completed_statusInternal
session_idInternal
client_extract_process_idInternal
server_nameInternal

/next

Fetch the next available load.

MethodGET
Path/update/next
Parameter
ValuesDescription

@max_client_modified_load_idInteger: e.g., 251234The maximum modified_load_id in the table xml.t_patent_document_values of the on-site PostgreSQL database

Example

Request

wget -O- -q  \
  --header 'x-user:x' \
  --header 'x-password:y' \
'https://cdws21.ificlaims.com/update/next?max_client_modified_load_id=260221'

Response

{
   "status" : "success",
   "time" : "0.111",
   "load_info" : {
      "session_id" : "000000260222-IFI-Cont",
      "load_source" : "IFI-Cont",
      "completed_stamp" : "2017-03-22 22:13:03.325308",
      "load_id" : 260222,
      "running_status" : "complete",
      "entered_stamp" : "2017-03-22 22:12:59.04867",
      "completed_status" : "success",
      "client_extract_process_id" : 121592,
      "url" : "https://alexandria.fairviewresearch.com/dwh/20170322/000000260222-IFI-Cont.tar.gz",
      "ndocs" : 1,
      "server_name" : "adbbr02"
   }
}

Please see above for a detailed description of the response members.

/info

Fetch information pertaining to a particular load-id.

MethodGET
Path/update/info
Parameter
ValuesDescription

@load_idInteger: e.g., 372122The modified-load-id  of interest

Example

Request

wget -O- -q  \
  --header 'x-user:x' \
  --header 'x-password:y' \
'https://cdws21.ificlaims.com/update/info?load_id=372122'

Response

{
   "status" : "success",
   "time" : "0.105",
   "load_info" : {
      "priority" : 0,
      "load_source" : "DOCDB",
      "completed_stamp" : "2019-07-18 10:35:28.128316",
      "load_id" : 372122,
      "office" : "EP",
      "running_status" : "complete",
      "completed_status" : "success",
      "entered_stamp" : "2019-07-18 10:24:37.959904",
      "ndocs" : 1
   }
}

The load_info  structure members are described below.

MemberDescription
priorityThe load priority. A higher priority positions this load in front of those with low priorities.
load_sourceThe load source. Please see a description of available load sources.
completed_stampTime stamp load was completed
load_idThe modified-load-id
officeThe issuing authority
running_statusRunning state of load
completed_statusCompleted status of load
entered_stampTime stamp of load begin
ndocsNumber of documents contained in this load
  • No labels