JSON päringustringiks
Koostage JSON-objektist URL päringustring. Kõik väärtused kodeeritakse protsendikoodistusega, pesastatud objektides kasutatakse nurksulgudega kirjaviisi, näiteks filter[status]=open, ning massiivid kirjutatakse korduvate võtmetena, nurksulgudega, indeksitega või komadega eraldatud loenditena. Valige tühikute jaoks %20 või +, et see sobiks URL lugeva serveriga.
Korduma kippuvad küsimused
Millised massiivivormingud on saadaval?
Repeat kirjutab ids=1&ids=2, brackets kirjutab ids[]=1&ids[]=2, indices kirjutab ids[0]=1&ids[1]=2 ja comma kirjutab ids=1,2. Repeat on vorming, mida saadavad URLSearchParams ja enamik HTTP-kliente; PHP ja Rails eeldavad nurksulge või indekseid.
Kuidas pesastatud objekte kirjutatakse?
Nurksulgudega: {"filter": {"status": "open"}} muutub kujule filter[status]=open. Sügavamate objektide puhul lisandub rohkem nurksulge, näiteks a[b][c]=1.
Kas tühikute asemel kasutada %20 või +?
Mõlemad tähistavad päringustringis tühikut. %20 sobib mis tahes URL osas, + aga on see, mida HTML-vormid saadavad. Enamik servereid aktsepteerib mõlemat, seega valige see, mida kasutab teie server või API dokumentatsioon.
Miks kodeeritakse nurksulud kujule %5B ja %5D?
Nurksulud on URL-ides reserveeritud märgid, seega kodeeritakse need vaikimisi protsendikoodiga, nagu teevad PHP http_build_query ja qs-teek. Lülitage loetavad nurksulud sisse, et jätta need kujule [ ja ]; enamik servereid aktsepteerib neid samuti.
Millised märgid jäetakse kodeerimata?
Tähed, numbrid ja märgid - _ . ! ~ * ' ( ) jäetakse muutmata. Kõik muu, sealhulgas &, =, # ja mitte-ASCII tähed, kodeeritakse UTF-8-na protsendikoodiga.
Kuidas kirjutatakse null ja tõeväärtused?
true, false ja numbrid kirjutatakse tekstina, näiteks active=true. null muutub tühjaks väärtuseks, näiteks note=.