Zum Entfernen von Tags einer Person ist vorheriges Authentifizieren notwendig. Der Ablauf ist folgender:
1. Laden des Authorization Tokens (siehe "API: Authentifizierung")
POST <cambuildr-url>/oauth/login (mit username und password)
2. Laden der bisherigen Tags der Person, Entweder über den Identifier, oder über die E-Mail:
GET <cambuildr-url>/api/v1/people/{identifier}GET <cambuildr-url>/api/v1/[email protected]
Der Response sieht dann z.B. so aus:
{
"error": false,
"person": {
"id": 258475, ...
"tags": [
{ "id": 1, "screen_name": "tag1" },
{ "id": 2, "screen_name": "tag2" },
{ "id": 3, "screen_name": "tag3" }
]
}
}Das sind die Tags, die die Person momentan hat.
3. Speichern der Person, Mitsenden aller Tags ausser dem, der entfernt werden soll. Dadurch ist sichergestellt, dass auch nur dieser eine entfernt wird, und alle anderen beibehalten bleiben. Achtung: Alle Tags, die nicht mitgesendet werden, werden von der Person entfernt, sie hat danach NUR mehr die gesendeten Tags.
Angenommen der Tag ‚tag3‘ soll weggenommen werden, dann wäre das:
POST <cambuildr-url>/api/v1/people
{
"id" : 258475,
"tags": [ { "screen_name": "tag1" }, { "screen_name": "tag2"} ]
}
Bei den Requests 2 und 3 muss als Authentication ein Bearer-Token im Header mitgeschickt werden (der in Schritt 1 generiert wurde):
Authorization => Bearer {token}