Sample web service (API) for contact resources.
Syntax
Response = HTTP_Contacts_Services(RemainingURL)
Returns
The meaning of the response value depends on the HTTP request. Responses are strictly for debugging purposes only since web service routines should be using the services in the HTTP_Service routine.
Parameters
Parameter | Description |
---|---|
RemaiiningURL | The remaining portion of the URL that follows the URL that launched this current service. This information is used in the HTTP_Service_Setup insert to populate other useful variables. Required. |
Remarks
HTTP_Authentication_Services
is an application service module that handles authentication into the API. By default this service is automatically called within the HTTP_MCP controller routine. It is recommended that this be left in place. If the developer wishes to disable authentication (either temporarily for testing purposes or permanently), it is better to set the Enable Authentication Flag to 0 in the SRP_HTTP_FRAMEWORK_SETUP configuration record.
Authentication is different from authorization (even though HTTP Basic Authentication uses the Authorization request header field) and this is important when building access to the API. Authentication normally means the user’s credentials are valid. However, this does not guarantee that the user has sufficient privileges to access (or modify) the requested resource. This is where authorization comes in. Failure in authentication or authorization can both return a 401 (Unauthorized) status code, but a failed authorization might return a 403 (Forbidden) status code. Web service code that easily retrieve the authentication credentials to make authorization decisions.
Services
Service | Description |
---|---|
AuthenticateRequest | Usage: Comments: Returns: |
CleanUp | Usage: Comments: Returns: |
Param1 - Param10
The proper use of the generic arguments are defined in the definition of each service above.