REST API v1: PUT collection field

Waarschuwing: Je bekijkt nu het overzicht voor de oude versie van onze API. Wij raden aan om onze laastste versie van de API te gebruiken.

Methode om een bepaald veld in een collectie aan te passen. Om deze methode uit te voeren kun je een HTTP PUT verzoek sturen aan de volgende URL:

https://api.copernica/com/v1/collection/$id/field/$id?access_token=xxxx

De eerste $id is de collectie waarvan je het veld aan wilt passen en de tweede $id is de ID van het veld dat je aan wilt passen. De rest van de informatie voor het veld moet toegevoegd worden aan de message body van het HTTP verzoek.

Beschikbare parameters

De volgende variabelen kunnen meegegeven worden aan de body van het verzoek:

  • name: Naam van het veld
  • type Type van het veld
  • value: Waarde van het veld
  • displayed: Boolean waarde om aan te geven of het veld zichtbaar moet zijn in lijsten en grids in de gebruikers interface
  • ordered: Boolean waarde om aan te geven of profielen standaard bij dit veld gesorteerd moeten worden
  • length: Maximum lengte voor text velden
  • textlines: Hoeveelheid regels beschikbaar in text velden
  • hidden: Boolean waarde om aan te geven of een veld altijd verborgen moet worden voor een gebruiker
  • index: Boolean waarde om aan te geven of er een index aangemaakt moet worden op het veld

Voorbeeld in PHP

Het volgende PHP script demonstreert hoe deze methode gebruikt kan worden. somebody unsubscribes, the field ‘newsletter’ is set to ‘no’.

// dependencies
require_once('copernica-rest-api.php');

// change this into your access token
$api = new CopernicaRestApi("your-access-token");

// data to be sent to the api
$data = array(
    'name'      => 'nieuwe_naam'
);

// do the call
api->put("collection/1234/field", array(), $data);

Dit voorbeeld vereist de REST API class.

Meer informatie