Passa al contenuto principale
Supporto OCLC

Add Request

Find information about the AddRequest service URL, JSON elements, and Request templates and examples.

AddRequest service URL:

http://HOSTNAME/portal-service/request/add?aid=${aid}

where ${aid} is the authorization id for the user logged in.  The {aid} is provided by the Authentication service.

For example:

         http://HOSTNAME/dws/item/available?aid=YkbOGfBGv6hKLefABkWJP2yYlI8

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 it's User-Agent value. See Authentication for more information. 

AddRequest request body: JSON elements

View the full list of elements in the request body
  • PartnershipId
    • Partnership ID indicating to which consortium/group the library belongs.
    • Contact Relais International for the Partnership ID.
    • Richiesto.
  • SupplyingLibrarySymbol
  • ParentRequest
  • ParentRequestNumber
  • IsLastChild
  • BibliographicInfo
    • Titolo
    • Autore
    • SubTitle
    • SeriesTitle
    • Edizione
    • ArticleTitle
    • ArticleAuthor
    • Volume
    • Problema
    • PhysicalDescription
    • ItemOrFolderNumber
    • AccessionNumber
    • BoxNumber
    • ImageOrPageNumber
    • PagesRequested
    • EstimatedPages
    • ISSN
      • ISSN1
      • ISSN2
    • ISBN
      • ISBN1
      • ISBN2
    • ISMN
    • CallNumber
    • AdditionalNumbers
    • Sponsor
    • InformationSource
    • OCLCRecNo
    • Sistema
    • SystemNumber
    • LCCN
    • Bibliografia
    • BibliographyNumber
    • BibId
    • LocalItemFound
  • Località
    • SupplierCodes
      • SupplierCode
      • BibID
      • ItemID
      • CallNumber
      • SummaryHoldings
    • LocationDescriptions
      • LocationDescription
      • BibID
      • ItemID
      • CallNumber
      • SummaryHoldings
  • PublisherInfo
    • Editore
    • PublicationType
    • PublicationDate
    • PublicationPlace
  • RequestInfo
    • ServiceType
    • ServiceLevel
    • RequestSource
    • DateSubmitted
    • Nota
    • Requester
    • Mailbox
    • NLMUniqueID
    • ExternalNumber
    • ExpiryDate
    • NeedByDate
    • MaximumCost
    • ProjectCode
    • AgreedTermsConditions
    • CopyrightComply
  • Copyright
  • Codice
    • TermsComply
    • PublishPurpose
    • TermsOfUse
    • Holder
    • Status
  • DocumentDetails
    • Dimensione
    • Cropping
    • Finishing
  • DocumentCharges
    • PaymentMethod
    • PaymentProcessed
    • AmountQuoted
    • BaseCharge
    • CopyrightCharge
    • DeliveryCharge
  • ElectronicDocument
    • Path
    • SupplyCode
  • SystemNumbers
    • OclcNumber
    • OpacNumber
    • MedlineNumber
    • DoclineNumber
    • DoclineFlag
  • DeliveryAddress
    • FirstName
    • Surname
    • Dipartimento
    • InstitutionName
    • LibraryName
    • Address1
    • Address2
    • Città
    • ProvinceState
    • PostalZipCode
    • Paese
    • ContactPhone
  • Preauthorized
    • TransactionNumber
    • TokenNumber
  • CreditCard
    • CardType
    • CardName
    • CardNumber
    • CardExpiryDate
    • CardSecurityCode
  • ElectronicDelivery
    • FileFormat
    • OutputFormat
    • DeliveryMethod
    • DeliveryAddress
    • MessagingMethod
    • MessagingAddress

Request template and examples

The following templates are examples that can be downloaded:

AddRequest response: JSON elements

The response from this service is a JSON string.

  • RequestNumber: The request number assigned by Relais.
  • ConfirmMessage: As configured for your library.

The following is a sample response for an successful request:

{    
    "RequestNumber": "REG-10000079",
    "ConfirmMessage": "Your request has been submitted (Request Number: REG-10000079)" 
}

Errors

The following is a sample response for an unsuccessful request:

{
  "Problem":{
     "ErrorCode":"PUBAR001",
     "ErrorMessage":"Missing parameter :Title is required"
  }

}

This service may return the following error codes and messages:

Codice Tipo Messages

PUBSC001

Pubblico Invalid request
PUBSC007 Pubblico Invalid JSON request
PUBSC005 Pubblico Invalid aid
PUBSC008 Pubblico User group not authorized to access the service

PUBAR001,

PUBAZ001

Pubblico

Missing parameter

  • PortalGroup is required.
  • Patron id is required.
  • Library symbol is required.
  • Bibliography information is required.
PUBAR002 Pubblico This is a duplicate of a recent request.  This request will not be submitted
PUBAR003 Pubblico Invalid parameter
PUBAR004 Pubblico SMTP timeout error
PRIAR001 Pubblico Internal add request error
PRIAZ001 Privato Internal authorization error