Difference between revisions of "Add Customer"

From MyMobileWorkers API
Jump to: navigation, search
(→‎Example JSON)
Line 1: Line 1:
 
== Summary ==
 
== Summary ==
 +
 +
 +
The add customer action allows users to attach a customer to their company.
 +
This method accepts an array of customers to be added to the system.
 +
A customer can be created via two different methods - either as multi-part form data with a JSON file attached and the API key as a parameter, or as JSON content on it's own, with the API key supplied within the JSON.
 +
 +
==== Multi Part Form Data ====
 
{| border="1" class="wikitable"
 
{| border="1" class="wikitable"
  
Line 22: Line 29:
 
|}
 
|}
  
−
The add customer action allows users to attach a customer to their company.
+
==== JSON As Body ====
 +
{| border="1" class="wikitable"
 +
! Add Customer - JSON
 +
! colspan="2" |
 +
|-
 +
!  URL
 +
| colspan="2" | http://base_url/api_path/version/companies/company/customers/customer
 +
|-
 +
! Type
 +
| colspan="2" |POST
 +
|-
 +
!
 +
| JSON <br /> {key, validate_only(optional), update_existing(optional), customers[]}  ||| required   
 +
|-
 +
! Response
 +
| colspan="2" | JSON
 +
|}
  
−
== JSON Parameters ==
+
== JSON Contents ==
  
 
{| border="1" class="wikitable"
 
{| border="1" class="wikitable"
Line 60: Line 83:
 
|}
 
|}
  
−
=== Example JSON ===
+
{| border="1" class="wikitable"
 +
|+ Fields exclusive to JSON body format:
 +
! colspan="3" | Standard Fields
 +
|-
 +
! Field
 +
! Expected Data
 +
! Required
 +
|-
 +
! key
 +
| string - company api key || &#10003;
 +
|-
 +
! updating_existing
 +
| boolean ||
 +
|-
 +
! validate_only
 +
| boolean ||
 +
|-
 +
|}
 +
 
 +
== Example Input ==
 +
 
 +
==== Multi Part Form Data ====
 +
 
 +
<source lang="java">
 
   "customers":[
 
   "customers":[
 
       {
 
       {
Line 70: Line 116:
 
       }
 
       }
 
   ]
 
   ]
 +
</source>
 +
 +
==== JSON As Body ====
 +
<source lang="java">
 +
{"key":"test", "validate_only":"true", "update_existing":"true", "customers":[
 +
      {
 +
        "name":"LeeLand",
 +
        "contact_name":"Mark Moose",
 +
        "address_1":"1 the street",
 +
        "postcode":"WA12 0JQ",
 +
        "contact_number":"01942295900"
 +
      }
 +
  ]
 +
}
 +
</source>
 +
 +
== Example Curl Requests ==
 +
 +
==== Multi Part Form Data ====
  
−
== Example curl request ==
 
 
curl -F validate_only=false -F update_existing=true -F api_key=YOURKEY -F file=@/Users/lee_orritt/Desktop/webAPICurling/create_customer.txt  http://test.mymobileworkers.com:8080/api/1/companies/company/customers/customer
 
curl -F validate_only=false -F update_existing=true -F api_key=YOURKEY -F file=@/Users/lee_orritt/Desktop/webAPICurling/create_customer.txt  http://test.mymobileworkers.com:8080/api/1/companies/company/customers/customer
 +
 +
==== JSON As Body ====
 +
 +
curl -X POST -H "Content-Type: application/json" -d '{"key":"darrenwebapi", "validate_only":"false", "update_existing":true,"customers":[{"name":"LeeLand","contact_name":"testName","address_1":"1 the street","postcode":"WA12 0JQ","contact_number":"01942295900"}]}' http://live.mymobileworkers.com:8080/api/1/companies/company/customers/customer
  
 
== Responses ==
 
== Responses ==
 +
 
=== Example JSON ===
 
=== Example JSON ===
  

Revision as of 09:57, 21 August 2013

Contents

Summary

The add customer action allows users to attach a customer to their company. This method accepts an array of customers to be added to the system. A customer can be created via two different methods - either as multi-part form data with a JSON file attached and the API key as a parameter, or as JSON content on it's own, with the API key supplied within the JSON.

Multi Part Form Data

Add Customer
URL http://base_url/api_path/version/companies/company/customers/customer
Type POST
Params: api_key required
file required
Response JSON

JSON As Body

Add Customer - JSON
URL http://base_url/api_path/version/companies/company/customers/customer
Type POST
JSON
{key, validate_only(optional), update_existing(optional), customers[]} 		required
Response JSON

JSON Contents

The JSON file is passed in the post as the "file"
Standard Fields
Field Expected Data Required
contact_name varchar(45)
* must be unique		 ✓
name varchar(255)
address_1 varchar(45)
address_2 varchar(45)
address_3 varchar(45)
address_4 varchar(45)
postcode varchar(45)
contact_number varchar(45)
Fields exclusive to JSON body format:
Standard Fields
Field Expected Data Required
key string - company api key ✓
updating_existing boolean
validate_only boolean

Example Input

Multi Part Form Data 

   "customers":[
      {
         "name":"LeeLand",
         "contact_name":"Mark Moose",
         "address_1":"1 the street",
         "postcode":"WA12 0JQ",
         "contact_number":"01942295900"
      }
   ]

JSON As Body 

{"key":"test", "validate_only":"true", "update_existing":"true", "customers":[
      {
         "name":"LeeLand",
         "contact_name":"Mark Moose",
         "address_1":"1 the street",
         "postcode":"WA12 0JQ",
         "contact_number":"01942295900"
      }
   ]
}

Example Curl Requests

Multi Part Form Data

curl -F validate_only=false -F update_existing=true -F api_key=YOURKEY -F file=@/Users/lee_orritt/Desktop/webAPICurling/create_customer.txt http://test.mymobileworkers.com:8080/api/1/companies/company/customers/customer

JSON As Body

curl -X POST -H "Content-Type: application/json" -d '{"key":"darrenwebapi", "validate_only":"false", "update_existing":true,"customers":[{"name":"LeeLand","contact_name":"testName","address_1":"1 the street","postcode":"WA12 0JQ","contact_number":"01942295900"}]}' http://live.mymobileworkers.com:8080/api/1/companies/company/customers/customer

Responses

Example JSON 

{"file":"tick.png","comment":"Transferred from API","created_at":"2013-05-20T14:42:37+00:00"}
Retrieved from ‘https://docs.mymobileworkers.com/index.php?title=Add_Customer&oldid=425’
Personal tools
Namespaces

Variants
Actions
Navigation
Toolbox