Difference between revisions of "Bxp API - APP API"

From All n One's bxp software Wixi

Jump to: navigation, search
(Created page with "= Warning! = This document is under construction. = Introduction = The bxp API (Application Programming Interface) allows digital interaction with bxp without the need...")
 
 
(16 intermediate revisions by the same user not shown)
Line 1: Line 1:
= Warning! =
+
= Source =
  
  
This document is under construction.
+
N.B.  This API is a subst of the full bxp API [[Bxp_API]]
  
  
Line 13: Line 13:
  
 
The bxp APP API is a subset of the bxp API designed specifically to work with APPs.
 
The bxp APP API is a subset of the bxp API designed specifically to work with APPs.
 +
  
  
Line 28: Line 29:
  
 
After login, all function calls must include the tokens in order for the API to respond correctly.
 
After login, all function calls must include the tokens in order for the API to respond correctly.
 +
  
  
 
= Functions =
 
= Functions =
  
= Login Function =
 
  
You must post four key pair values. (not including the semi colons)
+
== Function List ==
 +
 
 +
 
 +
The functions are laid out in terms of usual order of processing
  
* strFunction:login
+
Initial
* strSystem:client_demo
+
* login [[Bxp_API_APP_-_Function_-_Login]]
* strClient_Username:Demo Account
+
* settings [[Bxp_API_APP_-_Function_-_Settings_and_Confg]]
* strClient_Password:demoPassword
+
* config_primary [[Bxp_API_APP_-_Function_-_Settings_and_Confg#config_function]]
 +
* config_buttonX [[Bxp_API_APP_-_Function_-_Settings_and_Confg#config_function]]
  
The system will respond with XML.
 
  
<syntaxhighlight lang="xml">
+
Lister
<?xml version="1.0" encoding="UTF-8" ?>
+
* list_listee [[Bxp_API_APP_-_Function_-_Lister]]
<data>
+
* insert_listee [[Bxp_API_APP_-_Function_-_Lister#Create_Listee]]
<strFunction>login</function>
+
 
<strError></error>
+
 
<intClient_Id>123</userid>
+
Diary
<strClient_SessionField>asdfasdfasdf</strClient_SessionField>
+
* diary [[Bxp_API_APP_-_Function_-_Diary]]
</data>
+
 
</syntaxhighlight>
+
 
 +
Forms
 +
* formlookup  [[Bxp_API_APP_-_Function_-_Diary]]
 +
* insert_formrecord [[Bxp_API_APP_-_Function_-_Diary#Form_Insert_Function]]
 +
 
 +
 
 +
System
 +
* list_hamsters  [[Bxp_API_APP_-_Function_-_Hamster]]
 +
 
 +
 
 +
Future build items
 +
* reminders (future build)
 +
* todo (future build)
 +
* list_reminders  (future build)
 +
* list_appointment  (future build)
 +
 
 +
 
 +
 
 +
 
 +
= Error Listing =
 +
 
 +
 
 +
For a full listing of all errors [[Bxp_API_APP_-_Error_Listing]]
  
  
Line 61: Line 87:
  
 
More details on the original project spec can be found here.
 
More details on the original project spec can be found here.
 +
 +
 +
 +
[[Category:Topic:bxp_APP_API]]
 +
[[Category:Topic:bxp_API]]

Latest revision as of 12:50, 5 September 2015

1 Source

N.B.  This API is a subst of the full bxp API Bxp_API


2 Introduction

The bxp API (Application Programming Interface) allows digital interaction with bxp without the need for a human to interact with bxp.


The bxp APP API is a subset of the bxp API designed specifically to work with APPs.


3 How it works

The APP API requires secure posts to be sent to the relevant system. This can be done using a number of DOM (Document Object Technologies)


The primary post is sent to https://ww3.allnone.ie/client/client_demo/cti/userAPP_Main.asp You must replace client_demo with the system you are communicating with.


A number of criteria must be passed for the process to work. The first process is a login process which will provide tokenisation for your app.


After login, all function calls must include the tokens in order for the API to respond correctly.


4 Functions

4.1 Function List

The functions are laid out in terms of usual order of processing

Initial


Lister


Diary


Forms


System


Future build items

  • reminders (future build)
  • todo (future build)
  • list_reminders (future build)
  • list_appointment (future build)



5 Error Listing

For a full listing of all errors Bxp_API_APP_-_Error_Listing


6 History

This API was developed to further the work of Calvin O'Brien and Adam McGivern who work as interns in All n One developing the bxp APP for iPhone, Android and Microsoft devices.

More details on the original project spec can be found here.