ServiceM8通过API创建新工作

时间:2016-06-16 16:52:55

标签: php

我将以下JSON发送到SM8 API https://api.servicem8.com/api_1.0/job.json

我得到的回复是200 OK,&正在我的servicem8仪表板中创建作业,但由于某种原因未填充名称和描述字段。

另外,我希望从响应对象中捕获新创建的作业ID,但要么没有返回,要么我不确定如何访问它。

这是我传递给API的JSON:

{
    "status":"Quote",
    "job_address":"123 Street Lane, , London, SE2",
    "description":"Remove & replace existing carpets",
    "contact_first":"Joe",
    "contact_last":"Bloggs"
}

任何人都能看到问题所在?

干杯

1 个答案:

答案 0 :(得分:0)

最初创建记录时,在名为x-record-uuid的HTTP标头中返回新创建的记录的UUID。

未填充说明,因为字段名称必须为job_description(而不是description)。

需要通过JobContacts端点(http://developer.servicem8.com/docs/rest-api/reference/jobcontact-3/)填充作业的联系详细信息。 contact_firstcontact_last不是作业对象的有效字段名称。

因此,对于您的示例记录,您需要执行以下操作:

  1. 将作业详细信息(status,job_address,job_description)发布到作业终结点
  2. 检查x-record-uuid标头以确定刚刚创建的作业的UUID
  3. 向JobContact端点发送另一个请求以创建作业联系人。将job_uuid设置为已创建作业的UUID。您可能希望设置type = JOB和is_primary_contact = 1。它看起来像这样:

    {
        "first":"Joe",
        "last":"Bloggs",
        "job_uuid":"7d97be49-0eff-417a-8251-ab8b8942d65b",
        "type":"JOB",
        "is_primary_contact":1
    }