== Web catalog ==

Below is a list of the existing web endpoints along with notes regarding their current state of use and proposed future development.

Part of the purpose for documenting them here is to consider future development needs as we move to upgrading from PHP 5.6 to PHP 7.x (a move which is necessary before the end of the year as all updates, including critical security issues, ceases for PHP 5.6 on 31st December 2018).


{{{#!table
{{{#!th style="padding: 0 10px; font-weight: bold;"
Endpoint
}}}
{{{#!th style="padding: 0 10px; font-weight: bold"
Purpose 
}}} 
{{{#!th style="padding: 0 10px; font-weight: bold" 
Current state 
}}} 
{{{#!th style="padding: 0 10px; font-weight: bold" 
Future plans 
}}}
|----------------------------------
    {{{#!td style="padding: 0 10px; vertical-align: top;"

/order

    }}}
    {{{#!td style="padding: 0 10px; vertical-align: top;"

Emailed to clients to enable them to pay for orders
  - presents details of the user's order
  - will find multiple unpaid order based on client ID and request payment for all if found

    }}}
    {{{#!td style="padding: 0 10px; vertical-align: top;"

Still required (approx. 10% of all payments are made through this endpoint.)

    }}}
    {{{#!td style="padding: 0 10px; vertical-align: top;"

Migrate to use the !FileMaker DataAPI

    }}}
|----------------------------------
    {{{#!td style="padding: 0 10px; vertical-align: top;"

/process

    }}}
    {{{#!td style="padding: 0 10px; vertical-align: top;"

Second step in the payment process. Presents an accordion with
 - Summary of the job details (exact details depends on the number of jobs being paid)
 - Card details form
 - Card billing address form

    }}}
    {{{#!td style="padding: 0 10px; vertical-align: top;"

Still required

    }}}
    {{{#!td style="padding: 0 10px; vertical-align: top;"

Migrate to use the !FileMaker DataAPI

    }}}
|----------------------------------
    {{{#!td style="padding: 0 10px; vertical-align: top;"

/account

    }}}
    {{{#!td style="padding: 0 10px; vertical-align: top;"

Allows account customers to view unpaid job invoices, including generating a pdf invoice.

    }}}
    {{{#!td style="padding: 0 10px; vertical-align: top;"

Still required

    }}}
    {{{#!td style="padding: 0 10px; vertical-align: top;"

Migrate to use the !FileMaker DataAPI

    }}}
|----------------------------------
    {{{#!td style="padding: 0 10px; vertical-align: top;"

/3D

    }}}
    {{{#!td style="padding: 0 10px; vertical-align: top;"

Optional 3D secure step in payment process

    }}}
    {{{#!td style="padding: 0 10px; vertical-align: top;"

Still required

    }}}
    {{{#!td style="padding: 0 10px; vertical-align: top;"

Migrate to use the !FileMaker DataAPI

    }}}
|----------------------------------
    {{{#!td style="padding: 0 10px; vertical-align: top;"

/internal

    }}}
    {{{#!td style="padding: 0 10px; vertical-align: top;"

Used internally to take payments over the phone (money bag).

    }}}
    {{{#!td style="padding: 0 10px; vertical-align: top;"

Still required

    }}}
    {{{#!td style="padding: 0 10px; vertical-align: top;"

Migrate to use the !FileMaker DataAPI

    }}}
|----------------------------------
    {{{#!td style="padding: 0 10px; vertical-align: top;"

/particle

    }}}
    {{{#!td style="padding: 0 10px; vertical-align: top;"

Seems to have two functions
 - send a notification email if a smoke detector is activated (presume called by some IoT detector?)
 - creates an entry in both !FileMaker and a MySQL table each time a door status changes. (again presume IoT switch?)

    }}}
    {{{#!td style="padding: 0 10px; vertical-align: top;"

Obsolete

    }}}
    {{{#!td style="padding: 0 10px; vertical-align: top;"

No further action

    }}}
|----------------------------------
    {{{#!td style="padding: 0 10px; vertical-align: top;"

/postcode

    }}}
    {{{#!td style="padding: 0 10px; vertical-align: top;"

Interact with Postcode Anywhere

    }}}
    {{{#!td style="padding: 0 10px; vertical-align: top;"

Obsolete. Replaced with getAddress() called directly from within FM

    }}}
    {{{#!td style="padding: 0 10px; vertical-align: top;"

No further action

    }}}
|----------------------------------
    {{{#!td style="padding: 0 10px; vertical-align: top;"

/webform

    }}}
    {{{#!td style="padding: 0 10px; vertical-align: top;"

Receives orders from the website to add to !FileMaker

    }}}
    {{{#!td style="padding: 0 10px; vertical-align: top;"

Used constantly and a critical component in the business system.

    }}}
    {{{#!td style="padding: 0 10px; vertical-align: top;"

Migrate to use the !FileMaker DataAPI.

Consider rebuilding into a more modern API endpoint. The current version was built in early 2011 intended to be a 'drop-in' replacement for direct integration with the !FileMaker XML done by !SilkStream to provide better error handling and feedback to the remote system. As a consequence of this the data structure and the method of communication is decidely 'unique' and would benefit from complete rework. 

'''Note''' however that this will require changes on the web-end as well, so it may be better to rebuild an identical endpoint with modern coding.

    }}}
|----------------------------------
    {{{#!td style="padding: 0 10px; vertical-align: top;"

/history

    }}}
    {{{#!td style="padding: 0 10px; vertical-align: top;"

Generates XML responses with details about a client including their details, orders and delivery addresses. The [wiki:history-docs original developer documentation] provides details of this functionality.

    }}}
    {{{#!td style="padding: 0 10px; vertical-align: top;"

Obsolete

    }}}
    {{{#!td style="padding: 0 10px; vertical-align: top;"

Will be supported by a new API in the future.

    }}}
|----------------------------------
    {{{#!td style="padding: 0 10px; vertical-align: top;"

/media

    }}}
    {{{#!td style="padding: 0 10px; vertical-align: top;"

Locates image files in the 'numbers' folders and converts them to thumbnails for web display. See the [wiki:history-docs original developer documentation] for the /history endpoint for further details

    }}}
    {{{#!td style="padding: 0 10px; vertical-align: top;"

Obsolete

    }}}
    {{{#!td style="padding: 0 10px; vertical-align: top;"

Will be supported by a new API in the future.

    }}}
|----------------------------------
    {{{#!td style="padding: 0 10px; vertical-align: top;"

/admin

    }}}
    {{{#!td style="padding: 0 10px; vertical-align: top;"

Two purposes here
 - used to deploy changes to the web code from version control
 - used to register the !DataGuard plugin

    }}}
    {{{#!td style="padding: 0 10px; vertical-align: top;"

Obsolete

    }}}
    {{{#!td style="padding: 0 10px; vertical-align: top;"

No further action.

    }}}
|----------------------------------
    {{{#!td style="padding: 0 10px; vertical-align: top;"

/webfleet

    }}}
    {{{#!td style="padding: 0 10px; vertical-align: top;"

Interacts with the !TomTom !WebFleet API. There is also an associated set of command line tools associated with !WebFleet.

    }}}
    {{{#!td style="padding: 0 10px; vertical-align: top;"

Obsolete

    }}}
    {{{#!td style="padding: 0 10px; vertical-align: top;"

No further action

    }}}
}}}