API (Application programming interface)

Wat moet er gebeuren voordat u aan de slag kunt:

Als eerste registreert u zich op 031handel.nl

Basisregels van 031handel.nl:

Zorg er goed voor dat de koppeling aan deze basisregels voldoet:

Bij misbruik wordt het account opgeheven

Succes met de verkoop van uw advertenties. Wij wensen u veel  handel toe!

Team 031handel.nl

Functie beschrijving

$auction_id = $client->createAuction(
    "Advertentie titel",
    "Advertentie beschrijving",
    "", // url naar een website
    1, // prijs type 1 Bieden vanaf, 2 vaste prijs, 3 tegen elk aannemelijk bod, 4 gratis
    20.50, // bedrag
    1193, // nummer van de sub-categorie
    array('http://www.example.tld/afbeelding_naam.jpg'), // lijst met afbeeldingen. Max 3. Deze moeten via het web beschikbaar zijn.
    "" // Als er een uniek nummer in uw eigen systeem beschikbaar is kunt u dit veld daarvoor gebruiken.
);

$client->deleteAuction(
    $auction_id, // auction_id dat terug gegeven wordt door de createAuction
    "" // Als u gebruik wilt maken van uw eigen unieke nummer kunt u voor auction_id 0 invullen en dit veld voor uw eigen nummer gebruiken
);

Voorbeeld PHP code

De code maakt gebruik van Zend_Framework

    // Auto loading
    require_once("Zend/Loader/Autoloader.php");
    $autoloader = Zend_Loader_Autoloader::getInstance();
   
    // Start Soap Client
   
    $wsdlOptions = array(
        'soap_version'   => SOAP_1_1,
        'wsdl'           => 'http://www.031handel.nl/api/index.php?wsdl',
        'encoding'       => 'UTF-8',
        'location'       => 'http://031handel.nl/api/index.php',
        'login'          => 'uw gebruikers naam',
        'password'       => 'uw wachtwoord',
    );
   
    $client = new Zend_Soap_Client();
    $client->setOptions($wsdlOptions);
    $client->setWsdlCache(false);


    // Een advertentie aanmaken   
    $auction_id = $client->createAuction("Test advertentie", "Dit is een ongeldige advertentie", "", 1, 20.50, 1193, array('http://www.example.tld/afbeelding_naam.jpg'), "");   
    var_dump($auction_id);
    if(is_numeric($auction_id)) {
        // Een advertentie verwijderen
        var_dump($client->deleteAuction($auction_id, ""));
    }


    try {
        // Ophalen van de categorieen.
        $xml = new SimpleXMLElement($client->listCategories());
       
        foreach($xml->children() as $category) {
            var_dump((string) $category);

            // Ophalen van de sub-categorieen
            $sub_xml = new SimpleXMLElement($client->listSubCategories((int) $category->attributes()->id));
            foreach($sub_xml->children() as $sub_category) {
                var_dump((int) $sub_category->attributes()->id);
                var_dump((string) $sub_category);
            }
           
            break;
        }
       
       
    } catch(Exception $e) {
        echo $e;
        var_dump($client->getLastRequest());
        var_dump($client->getLastResponse());
    }