API: verschil tussen versies

Uit Petities
Ga naar: navigatie, zoeken
(categorie developer)
(ondertekeningen)
Regel 20: Regel 20:
  
 
Na een succesvolle ondertekening wordt er een bevestiging e-mail naar het e-mailadres gestuurd. De link in dat e-mailtje wijst naar petities.nl en haakt in op het normale ondertekenings-proces.
 
Na een succesvolle ondertekening wordt er een bevestiging e-mail naar het e-mailadres gestuurd. De link in dat e-mailtje wijst naar petities.nl en haakt in op het normale ondertekenings-proces.
 +
 +
== petities ==
 +
===GET ===
 +
 +
 +
Een GET request naar:
 +
 +
http://api.petities.nl/api/v1/petities/[naam-gedeelte-van-petitie-uit-url].xml
 +
 +
geeft een XML document terug met informatie over de petitie. Het bevat:
 +
 +
* name : string; de volledige naam van de petitie
 +
* description : text; een korte beschrijving van de petitie
 +
* signatures_count : integer; het aantal bevestigde ondertekeningen van de petitie
 +
* petitioner_name : string; de naam van de petitionaris
 +
* petitioner_organisation : string; de organisatie van de petitionaris (indien ingevuld)
 +
* date_projected : date; verwachte datum van indiening
 +
* initiators : text; petitietekst, onderdeel 'Wij,'
 +
* statement : text; petitietekst, onderdeel 'Constateren,'
 +
* request : text; petitietekst, onderdeel 'en verzoeken,'
 +
  
 
[[Category:developer]]
 
[[Category:developer]]

Versie van 9 jan 2012 om 12:02

Het ontwikkelen van de Application Programming Interface is nog in een pril stadium. Zie ook developer ARN-24216-229. Met het onderstaande zou het mogelijk moeten zijn een ondertekening in onze database te injecteren. De ondertekenaar krijgt dan een e-mail met bevestigingslink op het ingevulde e-mailadres.

ondertekeningen

POST

Een POST request naar:

http://api.petities.nl/api/v1/petities/[naam-gedeelte-van-petitie-uit-url]/signatures.xml

met de volgende parameters:

  • name : string; naam van ondertekenaar (verplicht)
  • email : string; e-mailadres van ondertekenaar (verplicht)
  • city : string; woonplaats van ondertekenaar
  • visibility : boolean(0/1); toon ondertekening op website

Retourneert een 200 OK met een errors-array in xml met validatie errors, of een 200 OK met een lege errors-array wanneer de ondertekening succesvol is opgeslagen.

Na een succesvolle ondertekening wordt er een bevestiging e-mail naar het e-mailadres gestuurd. De link in dat e-mailtje wijst naar petities.nl en haakt in op het normale ondertekenings-proces.

petities

GET

Een GET request naar:

http://api.petities.nl/api/v1/petities/[naam-gedeelte-van-petitie-uit-url].xml

geeft een XML document terug met informatie over de petitie. Het bevat:

  • name : string; de volledige naam van de petitie
  • description : text; een korte beschrijving van de petitie
  • signatures_count : integer; het aantal bevestigde ondertekeningen van de petitie
  • petitioner_name : string; de naam van de petitionaris
  • petitioner_organisation : string; de organisatie van de petitionaris (indien ingevuld)
  • date_projected : date; verwachte datum van indiening
  • initiators : text; petitietekst, onderdeel 'Wij,'
  • statement : text; petitietekst, onderdeel 'Constateren,'
  • request : text; petitietekst, onderdeel 'en verzoeken,'