All dates must be in ISO format (Y-m-d\TH:i:s),and converted to UTC. In example, the entered time of December 31, 2014, 12:00PM EST would convert to December 31st 2014, 5:00PM UTC, and formatted and sent as 2014-12-31T16:00:00Z.
The following data examples are in JSON format.
Code Block |
---|
language | js |
---|
title | Authentication Name (authmap) |
---|
collapse | true |
---|
|
var authmap = {
"uid" : 1,
"authname" : "ethosce_authname",
"module" : "ethosce_ext_module",
}; |
Code Block |
---|
language | js |
---|
title | Cart Item (uc_cart_item) |
---|
collapse | true |
---|
|
var uc_cart_item = {
"cart_id" : 1, // The user"s uid
"nid" : 10, // The product"s nid
"qty" : 1,
}; |
Code Block |
---|
language | js |
---|
title | Course (course) |
---|
collapse | true |
---|
|
var course = {
"title" : "My New Course",
"type" : "course",
"field_course_summary" : {
"value" : "this is the summary<b>This is bold</b>", // Basic HTML structure is supported
"format" : "filtered_html"
},
"field_course_date" : {
"value" : date('Y-m-d\TH:i:s', 1471452801), // The course opening date. In ISO format
"value2" : date('Y-m-d\TH:i:s', 1471452801), // The course expiration date In ISO format
},
"model" : "SKU_1234",
"status" : 1,
}; |
Code Block |
---|
language | js |
---|
title | Course Credit (course_credit) |
---|
collapse | true |
---|
|
var course_credit = {
"nid" : 10,
"type" : "webservice_credit",
"increments" : 1,
"min" : 1,
"max" : 10,
"active" : 1,
"enable_variable_credit" : 1,
}; |
Code Block |
---|
language | js |
---|
title | Awarded Credit (course_credit_awarded) |
---|
collapse | true |
---|
|
var course_credit_awarded = {
"nid" : 10,
"uid" : 1,
"type" : "webservice_credit",
"credits" : 4,
}; |
Code Block |
---|
language | js |
---|
title | Course Enrollment (course_enrollment) |
---|
collapse | true |
---|
|
var course_enrollment = {
"nid" : 10,
"uid" : 1,
"enrollmenttype" : "webservice_call",
"type" : "webservice_call",
"status" : 1,
}; |
...
language | js |
---|
title | Course Object Fulfillment (course_object_fulfillment) |
---|
collapse | true |
---|
...
Date Formatting
There are 2 date formats used when interacting with the web service, epoch and ISO 8601. The call being made informs which format to use. All GET calls, to pull information from EthosCE, require the URL friendly epoch time. A call for creation or update must use the database compatible ISO 8601 format (Y-m-d\TH:i:
...
Code Block |
---|
language | js |
---|
title | Course Report (course_report) |
---|
collapse | true |
---|
|
var course_report = {
"nid" : 10,
"uid" : 1,
"grade_result" : 0,
"date_completed" : NULL,
"updated" : date('Y-m-d\TH:i:s', 1471452801), // In ISO format
"complete" : 0,
"section" : "course_content", // The course object module type
"section_name" : "Webservice Object",
"coid" : 30,
}; |
Code Block |
---|
language | js |
---|
title | Imported Transcript Record (transcript_import) |
---|
collapse | true |
---|
|
var transcript_import = {
"imported" : 0,
"nid" : 10,
"attended" : 0,
"complete" : 1,
"external_mail" : "webservice_user@dlcdev.com",
"date_completed" : date('Y-m-d\TH:i:s', 1471452801), // In ISO format
"start" : date('Y-m-d\TH:i:s', 1471452801), // In ISO format
"credit_type" : "webservice_credit",
"credits" : 10,
}; |
Code Block |
---|
language | js |
---|
title | Node (node) |
---|
collapse | true |
---|
|
var node = {
"title" : "my new page",
"type" : "page",
"body" : {
"value" : "this is the <b>body field</b>",
"format" : "filtered_html" // Text format is required
},
"author" : 1,
"status" : 1, // Published
}; |
Code Block |
---|
language | js |
---|
title | Order (uc_order) |
---|
collapse | true |
---|
|
var uc_order = {
"uid" : 1,
"customer" : 1, // The user"s uid
"delivery_address" : {
"first_name" : "Tom",
"last_name" : "Baker",
"company" : "DLC",
"street1" : "1520 Locust",
"street2" : "Suite 1000",
"city" : "Philadelphia",
"postal_code" : "19102",
"phone" : "215-321-1234",
"email" : "webservice_user@dlcdev.com"
},
"billing_address" : {
"first_name" : "WS First",
"last_name" : "WS Last",
"company" : "DLC",
"street1" : "1520 Locust",
"street2" : "Suite 1000",
"city" : "Philadelphia",
"postal_code" : "19102",
"phone" : "215-321-1234",
"email" : "webservice_user@dlcdev.com"
},
"order_status" : "completed",
"order_total" : 250.00,
"primary_email" : "webservice_user@dlcdev.com",
"payment_method" : "",
"created" : date('Y-m-d\TH:i:s', 1471452801), // In ISO format
"modified" : date('Y-m-d\TH:i:s',1471452801), // In ISO format
"host" : "127.0.0.1",
}; |
Code Block |
---|
language | js |
---|
title | Order (uc_order_product) |
---|
collapse | true |
---|
|
var uc_order_product = {
"order_id" : 60,
"nid" : 10,
"title" : "my new course",
"model" : "course_10",
"qty" : 1,
"cost" : 1,
"price" : 1,
}; |
Code Block |
---|
language | js |
---|
title | Profile (profile2) |
---|
collapse | true |
---|
|
var profile2 = {
"user" : 1,
"label" : "Profile",
"type" : "profile",
"field_first_name" : "Tom",
"field_middle_name" : "Stewart",
"field_last_name" : "Baker",
"field_profile_location" : {
"street" : "1520 Locust Street",
"additional" : "Suite 1000",
"city" : "Phila",
"province" : "PA",
"postal_code" : "19102",
"country" : "us",
},
// "field_boolean" : 1,
// "field_checkbox" : {
// "und" : {
// "option_one",
// "option_two",
// },
// },
}; |
...
language | js |
---|
title | User (user) |
---|
collapse | true |
---|
...
sZ). Additionally, both date formats must be converted to UTC before being sent, to ensure data integrity between systems.
Info |
---|
Entered local time: December 31, 2014, 12:00PM EST Converted to UTC/GMT: December 31, 2014, 5:00PM UTC ISO 8601 format: 2014-12-31T17:00:00Z Epoch format: 1420045200 |
Supported Data Structures
Child pages (Children Display) |
---|
|