Passa al contenuto principale
Supporto OCLC

Search/Statistics

Search/statistics is a service used to retrieve general statistics on an active search.

HTTP Method: GET 


HTTP Method: POST  
HTTP Header Content-Type: "application/json" 


HTTP Header User-Agent: ${user-agent}  
Standard HTTP clients (browser, HTTP client libraries, etc.) will automatically include its User-Agent value.

Search URL:

https://HOSTNAME/di/search/stat

Search/Stat parameters

Example Call

Search status with "aid" and "query" parameters

  • aid=12knsfd987234ldfd2
  • query=ti%3D%22The%20Stranger%22%20and%20au%3D%22Albert%22%20an d%20au%3D%22Camus%22
    { ti="The Stranger" and au="Albert" and au="Camus" }

https://HOSTNAME/di/search/stat?aid=12knsfd987234ldfd2&query=ti%3D%22The%20Stranger%22%20and%20au%3D%22Albert%22%20and%20au%3D%22Camus%22 

Status of a search for The Stranger by Albert Camus

Response

The response from this service is a JSON document.

Successful response request

The following is a sample response for a successful request (HTTP status 200 OK):

{
    "ActiveCatalog":0,
    "TotalItemCount":0,
    "CatalogsSearched":0,
    "CatalogsUnconnected":0,
    "CatalogsConnecting":0,
    "CatalogsWorking":0,
    "CatalogsIdle":0,
    "CatalogsFailed":0,
    "CatalogsError":0,
    "SearchProgress":0.0
}                                                   

Successful response glossary

Value Name Definizione

ActiveCatalog

An integer value indicating the number of catalogs being actively searched.

A value of 0 means that the search is complete.

CatalogsConnecting An integer value indicating the number of catalog connections currently in the connecting state.
CatalogsError An integer value indicating the number of catalog connections in an error state.
CatalogsFailed An integer value indicating the number of failed catalog connections.
CatalogsIdle An integer value indicating the number of catalog connections currently not in an idle state.
CatalogsSearched An integer value indicating the number of catalogs searched.
CatalogsUnconnected An integer value indicating the number of catalog connections currently not in a connected state.
CatalogsWorking An integer value indicating the number of catalog connections currently in the working state (searching, retrieving, etc.).

SearchProgress

A decimal value indicating the Progress of the current search.

A value of 1.0 means that the search is complete.

TotalItemCount An integer value indicating the number of items from all catalogs.

 Unsuccessful response request

{
    "Problem":  {
      "Code":  "PUBHG004",
      "Message": "Inactive search"
    }
}                                                                               

Problem codes and messages glossary

HTTP Status Codice Tipo Messaggio
400 Bad Request PUBHG001, PUBSC002 Pubblico Missing parameter
401 Unauthorized PUBSC004 Pubblico Invalid aid
401 Unauthorized PUBSC006 Pubblico User group not authorized to access the service
412 Precondition Failed PUBHG004 Pubblico Inactive search
500 Internal Server Error PRIHG001, PRISC001 Privato Internal error