Comparaison des versions

Légende

  • Ces lignes ont été ajoutées. Ce mot a été ajouté.
  • Ces lignes ont été supprimées. Ce mot a été supprimé.
  • La mise en forme a été modifiée.

Instructions

...

PUT {url}/localtrac/location/{locationUuid}/categories

This route will assign location’s external (apiservice) categories.

Request

Headers

Authorization

<token> obtained during the Authentication

Accept

application/json

Body (Example)

Bloc de code
{

	"bing": {
		"primary": {["0":"ccf2cec0-4d66-11e8-b54c-87b1280bf5b7"}],
		"secondary": {"0": "["d6e856a0-4d66-11e8-bca9-edca7c953810"}]
	}
	
}

{apiservice_slug}

Array of categories for this apiservice. apiservice_slug = bing in the example.

{apiservice_slug}.primary

Array of primary categories for this apiservice (usually it’s an array of one element). You should pass uuid of category, obtained from “search categories” route.

{apiservice_slug}.secondary

Array of secondary categories for this apiservice. You should pass uuid of categories, obtained from “search categories” route.

Response (200) - Success

Headers

Content-Type

application/json

Body

Bloc de code
{
  "bing": {
    "primary": "category.created",
    "secondary": "category.created"
  },
  <...>
}

Response(400) - Validation Error

This scenario happens if you sent any content who fails the minimum validation process. For instance, failing to provide valid apiservice name will lead to the following result

Headers

Content-Type

application/json

Body

Bloc de code
{

	"fb111": {
		"primary": {"0":"ccf2cec0-4d66-11e8-b54c-87b1280bf5b7"},
		"secondary": {"0": "d6e856a0-4d66-11e8-bca9-edca7c953810"}
	}
	
}

Response (403) - Forbidden access

This scenario happens if you sent non-existing locationUuid

Content-Type

application/json

Body

Bloc de code
{
  "message": "You do not have the required permission to alter this resource: location({locationUuid})"
}

...