Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

To use the API, you'll need a unique API Key, which is used to identify yourself to the PCR-360 server and to protect your data. API keys are assigned permissions that dictate the API access. These are available on the API Permissions page page. (Note: Do not share this unique key.)

...

Code Block
curl -X POST -d "sql=SELECT * FROM SERVICES" http://DOMAIN/api/API_KEY/sql.xml


For more details, see API:SQL .

Cable

This REQUEST type is deprecated.

. The cable REQUEST type allows access to PCR-360 Cables and related data. View full details on Cable API :CableCalls.

Services

This REQUEST type is deprecated.

. The services REQUEST type allows access to PCR-360 Services and related data. View full details on Services API :ServicesCalls.

Equipment

This REQUEST type is deprecated.

. The equipment REQUEST type allows access to PCR-360 Equipment and related data. View full details on Equipment API :EquipmentCalls.

GLA

This REQUEST type is deprecated.

. The gla REQUEST type allows access to PCR-360 Service Desk items and related data. View full details on GLA API :GLACalls.

Service Desk

This REQUEST type is deprecated.

. This servicedesk REQUEST variant allows access to PCR-360 Service Desk items and related data. View full details on Service Desk DataAPI Calls.

Service Desk Actions

This REQUEST type is deprecated.

. The servicedesk REQUEST type allows access to PCR-360 Service Desk items and related data. View full details on Service Desk ActionsAction API Calls.

Writing Data

The PCR-360 API allows an outside application to create or update Service, Equipment, or Service Desk items or submit SNMP traps. The basic write request is much like a read request; the URL is built in a similar fashion. Like the read requests, all API write operations are done via an HTTP(s) request (using cURL or some other method). You will need to build the URL to describe the request you are making.

...

Business logic and database integrity checks are enforced when inserting or updating data. If the required data is missing or incorrect, an error will be returned with a status of "failure" and a description of the failure. Possible failures include missing required data, incorrect or missing foreign keys, non-compliance to application business rules or logic, and Custom Validation rules.

A common error that occurs is a required field missing from the write request. It is important to keep in mind that any required user-defined fields that are created for a specific service desk type will also need to be defined when creating or updating a record.

...

The cable REQUEST type allows writting PCR-360 Cables and related data. View full details on Cable API :CableCalls.

Services

The services REQUEST type allows writing PCR-360 Services and related data. View full details on Services API :ServicesCalls.

Equipment

The equipment REQUEST type allows writing PCR-360 Equipment and related data. View full details on Equipment API :EquipmentCalls.

Service Desk

The servicedesk REQUEST type allows writing PCR-360 Service Desk items and related data. View full details on Writing Service Desk DataAPI Calls.

Service Desk Actions

The servicedesk REQUEST type variant allows writing PCR-360 Service Desk Action and related data. View full details on Writing Service Desk ActionsAction API Calls.

GLA

The gla REQUEST type allows writing PCR-360 GLA Records and related data. View full details on GLA API :GLACalls.

Custom

Custom API is available starting in version 2.1.4.0
The Custom REQUEST type allows the API to invoke custom PHP logic that is saved in the application. This is very useful when interfacing with an application where you cannot control the format or data in the outbound requests. The structure of a custom request type is dependent on the identifier specified in the Custom Logic > API entry. For more information on the syntax and capabilities available in the Custom Logic > API interface, see Custom Logic Syntax.

Using cURL, this example invokes a Custom API called hello-world and the header specifies the content type is JSON encoded and requests data returned JSON encoded:

...

Code Block
languagephp
linenumberstrue
{
    "udf_IDENTIFIER1" : "VALUE1"
    "udf_IDENTIFIER2" : "VALUE2"
    "udf_IDENTIFIER3" : "VALUE3"
}



Child pages (Children Display)navmap
styleh6api
sortapititle