Api >

Service Portal REST API

PUT updates Customer's Phonebook
Given I am authenticated as customer K0002
and there is a Phone Book with
  • id: 100
  • number: +49 (66) 1234-555
  • name: Phone Book
When I send /api/customers/K0002/phone-books/100
with application/json; charset=UTF-8 and following body:
{
  "data": [{
    "name": "displayName",
    "value": "New Phone Book"
  }, {
    "name": "displayNumber",
    "value": "+49 (66) 1234-888"
  }]
}
Then I should receive HTTP/1.1 204 No Content

Given I am authenticated as customer K0002
When I send /api/customers/K0002/phone-books/100
Then I should receive HTTP/1.1 200 OK
with following body:
{
  "href": "/api/customers/K0002/phone-books/100",
  "data": [{
    "name": "displayName",
    "value": "New Phone Book"
  }, {
    "name": "displayNumber",
    "value": "+49 (66) 1234-888"
  }]
}
Cannot update Phone Book if required properties are empty
Given I am authenticated as customer K0002
and there is a Phone Book with
  • id: 100
  • number: +49 (66) 1234-555
  • name: Phone Book
When I send /api/customers/K0002/phone-books/100
with application/json; charset=UTF-8 and following body:
{
  "data": [{
    "name": "displayName",
    "value": ""
  }, {
    "name": "displayNumber",
    "value": null
  }]
}
Then I should receive HTTP/1.1 400 Bad Request
with following body:
{
  "errors": [{
    "message": "field is required",
    "path": "displayName",
    "value": ""
  }, {
    "message": "field is required",
    "path": "displayNumber",
    "value": null
  }]
}
Cannot update Phone Book if displayName contains invalid characters
Given I am authenticated as customer K0002
and there is a Phone Book with
  • id: 100
  • number: +49 (66) 1234-555
  • name: Phone Book
When I send /api/customers/K0002/phone-books/100
with application/json; charset=UTF-8 and following body:
{
  "data": [{
    "name": "displayName",
    "value": "invalid=name"
  }]
}
Then I should receive HTTP/1.1 400 Bad Request
with following body:
{
  "errors": [{
    "message": "displayName contains invalid characters",
    "path": "displayName",
    "value": "invalid=name"
  }]
}
Cannot update Phone Book if displayName has invalid length
Given I am authenticated as customer K0002
and there is a Phone Book with
  • id: 100
  • number: +49 (66) 1234-555
  • name: Phone Book
When I send /api/customers/K0002/phone-books/100
with application/json; charset=UTF-8 and following body:
{
  "data": [{
    "name": "displayName",
    "value": "very long, long, long, long, long, long, long, long name"
  }]
}
Then I should receive HTTP/1.1 400 Bad Request
with following body:
{
  "errors": [{
    "message": "displayName must have length between 1 and 50",
    "path": "displayName",
    "value": "very long, long, long, long, long, long, long, long name"
  }]
}
Cannot update Phone Book if displayPhone has invalid format
Given I am authenticated as customer K0002
and there is a Phone Book with
  • id: 100
  • number: +49 (66) 1234-555
  • name: Phone Book
When I send /api/customers/K0002/phone-books/100
with application/json; charset=UTF-8 and following body:
{
  "data": [{
    "name": "displayNumber",
    "value": "(66) 1234-555"
  }]
}
Then I should receive HTTP/1.1 400 Bad Request
with following body:
{
  "errors": [{
    "message": "displayNumber has invalid format",
    "path": "displayNumber",
    "value": "(66) 1234-555"
  }]
}
Missing Phone Book
Given I am authenticated as customer K0002
And there is no Phone Book with ID 404 When I send /api/customers/K0002/phone-books/404
with application/json; charset=UTF-8 and following body:
{}
Then I should receive HTTP/1.1 404 Not Found
{
  "detail": "Phone Book with ID 404 has not been found",
  "title": "Phone Book not found",
  "described_by": "http://api.nfon.net/probs/phone-book-not-found"
}
Missing Customer
Given I am authenticated as Admin
When I send /api/customers/K0404/phone-books/100
with application/json; charset=UTF-8 and following body:
{}
Then I should receive HTTP/1.1 404 Not Found
{
  "detail": "Customer with identifier K0404 has not been found",
  "title": "Customer not found",
  "described_by": "http://api.nfon.net/probs/customer-not-found"
}
Customer should not be able to create another Customer's Phone Books
Given I am authenticated as Customer K0003
When I send /api/customers/K0002/phone-books/100
with application/json; charset=UTF-8 and following body:
{}
Then I should receive HTTP/1.1 403 Forbidden
{
  "title": "Access forbidden",
  "detail": "Access denied to [Customer] with id [K0002]",
  "described_by": "http://api.nfon.net/probs/invalid-authorization"
}
System Integrator should not be able to create Phone Book of a Customer that he cannot manage
Given I am authenticated as System Integrator S0002
When I send /api/customers/K0003/phone-books/100
with application/json; charset=UTF-8 and following body:
{}
Then I should receive HTTP/1.1 403 Forbidden
{
  "title": "Access forbidden",
  "detail": "Access denied to [Customer] with id [K0003]",
  "described_by": "http://api.nfon.net/probs/invalid-authorization"
}
Operator should not be able to create Phone Book of a Customer that he cannot manage
Given I am authenticated as Operator C0002
When I send /api/customers/K0003/phone-books/100
with application/json; charset=UTF-8 and following body:
{}
Then I should receive HTTP/1.1 403 Forbidden
{
  "title": "Access forbidden",
  "detail": "Access denied to [Customer] with id [K0003]",
  "described_by": "http://api.nfon.net/probs/invalid-authorization"
}