In questo post voglio riportarvi alcuni esempi pratici di funzionamento delle API, solo per evidenziare la loro semplicità e anche per capire che tipo di utilizzo se ne possa fare concretamente; per maggiori dettagli consultate la pagina dedicata e date un occhiata ai tutorial. Bene, possiamo iniziare.
La prima cosa di cui avete bisogno è una API key che potete ottenere semplicemente richiedendola a questo indirizzo (è necessaria la registrazione a PicNik); dovrete specificare il dominio nel quale utilizzerete il servizio e, nel caso lo vogliate, richiedere altre API keys (una per ogni dominio).
A questo punto possiamo da subito eseguire alcune operazioni di base; in questo post vediamo come inviare un' immagine all' editor semplicemente utilizzando alcuni parametri URL e come inserire un form che permetta agli utenti di caricare ed editare direttamente un immagine del loro computer.
Il primo esempio è semplicissimo, cliccate sull' immagine sotto, verrete reindirizzati nell' editor che a sua volta caricherà la stessa immagine:

Il codice necessario è questo (da inserire ovviamente <a href="qui"...):
http://www.picnik.com/service/?_import=http%3A//example.com/image.jpg&_apikey=YourApiKey
Si tratta solo di inserire alcuni parametri nel nostro URL (in grassetto le parti da personalizzare con il proprio percorso e API key).
Vediamo adesso qualcosa di più interessante; inseriamo un form dal quale ogni utente potrà caricare un immagine dal suo hard disk ed editarla in PicNik; qualcosa tipo questo:
E questo è il codice relativo:
<form method="post" action="http://www.picnik.com/service/" enctype='multipart/form-data'>
<input type="hidden" name="_import" value="image_file" />
<input type="file" name="image_file" size="30" ><br/>
<input type="submit" value="Upload this image"/>
<input type="hidden" name="_apikey" value="YourApiKey" />
</form>
Rispetto a questo esempio dovete inserire solo la vostra API key.
Concludo con una piccola nota, se volete importante: non ho ben chiaro un campo di applicazione (certo, ci sono gia alcuni esempi, ma non mi sembra niente di trascendentale); considerando però il supporto quasi completo di tutte le funzionalità del servizio e la possibilità di "far girare" il tutto sul proprio sito qualcosa ci deve essere...