QR API ha webhook-kuéra
API ohupytýta ne software-pe ejapo, emoambue, ehecha ha eipe'a QR kódigo-kuéra, ha ehecha hendaitépe moñe'ẽ resumen. Webhook-kuéra omondo peteĩ aviso firmado ne servidor-pe kódigo oñemoambue jave, moñe'ẽ oúva jave térã landing formulario oñemoĩva jave.
Mba'épa ojapo API ha webhook-kuéra
REST API oĩ /api/v1 tape-pe ha ohupyty JSON-pe. Ikatu omoĩ kódigo-kuéra ojehecha búsqueda ha etiqueta filtro rupi, páhina-pe 100 peve, ehecha peteĩ kódigo, ejapo, emoambue ha eipe'a kódigo-kuéra, ome'ẽ peteĩ SVG purá kódigo rehe, ha ehecha 30 ára moñe'ẽ resumen. Llave ha'e bearer token qrk_ rehe oñepyrũva ha peteĩ tembiapoha rehe, upévare pedido ikatu ojeporu kódigo-kuéra añoite upe tembiapoha-pe.
Webhook ha'e HTTPS dirección, ndéve registrádova evento-kuéra ndéve ojehecha hag̃ua. App omondo JSON marandu peteĩ-peteĩ evento-pe: kódigo ojejapo, emoambue térã eipe'a, tapicha moñe'ẽ ojehecha, térã landing formulario ojemoĩ. Prueba ojehu ping evento, upéicha ndeporã receptor ehecha tráfico real oúvo mboyve. Peteĩ-peteĩ delivery oñemoĩ firma HMAC-SHA256 webhook secret-gui, timestamp ha cuerpo rehe.
API ha'e tapicha ojapóva integración, ha noñemoambuéi kódigo ohechaukapa. SVG ha'e blanco ha negro, ndaguerekóiva logo, forma térã sa'y, ha estilo-kuéra editor-pe ojapo. API oikotevẽ Team plan. Llave oñeñongatu downgrade rire, ha ndoikóivéi peve tembiapoha oguerekóva jey plan API oguerekóva.
Mba'éicha eñepyrũ API eiporu
-
01
Ejapo llave owner-kuéra
Eike API kuatiarogue owner-kuéra ndive, emoĩ llave-pe téra, techapyrã ko servidor oiporúva, ha ejapo. Token ohechauka peteĩ jey añoite, upévare enseguida ojopyrõ secreto almacén-pe. Upe rire kuatiarogue ohechauka añoite téra, prefijo, ojapo ára ha mboýpa ojeporu jey pahápe.
-
02
Emondo llave peteĩ-peteĩ pedido-pe
Emondo token Authorization encabezado-pe, Bearer hérava, peteĩ jeteĩ ha token. Cuenta ojehecha ndehe peteĩ jey: respuesta ohéra tembiapoha, llave ha crédito oĩva, ha upéva ohechauka setup ojeporu porã. Llave ndoikói térã ojeporu vaʼekue, unauthorized respuesta ohupyty. Ndeikuaáiva llave ambue tembiapoha-pe ndojeporúi, upévare tembiapoha ndahasiri.
-
03
Ejapo, emoambue ha ehecha kódigo-kuéra
Emoĩ téra, kind (predeterminado ha joaju web), contenido ha campo opcional-kuéra: dinámico, slug, expiry, password, peteĩ dominio ojehechapyréva, etiqueta-kuéra ha estilo. Peteĩ kódigo ojapo jave peteĩ crédito ojerovia, ehecha ha emoambue ndaipórirã. Pedido ojehecha validación ndaipórirã oñemboguejy motivo-kuéra ha crédito oñemeʼẽ jeýta.
Mba'épa API oikotevẽ
-
Ticketing ha reserva
Sistema de reserva ohechauka peteĩ asiento rire, ojapo peteĩ dinámico kódigo upe boleto-pe ha ome'ẽ joaju mbyky ha SVG comprador-pe. Email térã wallet pase kódigo oñembohasa, ha ndaipóri tapicha ojekopia eskuéra mano rupi.
-
Stock ha activo etiqueta
Sistema warehouse ikatu ojapo peteĩ kódigo peteĩ ítem-pe, ítem número etiqueta-pe. Peteĩ-peteĩ moñe'ẽ oregistrá, ha sistema ikatu ehechakuaa 30 ára resumen peteĩ ítem-pe, ha ohechakuaa mboýpa etiqueta oñemoñe'ẽ pe ára-kuéra. Ítem ndaipóriva ojeikuaa jave, peteĩ kódigo ndaikatúi ojapo.
-
Menú restaurante-kuéra planilla rupi
Peteĩ script ikatu ohecha planilla de joaju menú ha oñemoambue peteĩ-peteĩ dinámico kódigo contenido API rupi. Kódigo impreso oĩ upéicha, ha ojehechakuaáva oúta próxima moñe'ẽ-gui.
-
Evento check-in ha formulario
Evento equipo ikatu emoĩ landing kuatiarogue formulario ndive ha webhook peteĩ-peteĩ respuesta-pe. Sistema ambue oreacciona evento-pe, upévare ndaipóri oikotevẽ ojeha'ã respuesta-kuéra.
-
Monitoreo ha alerta
Webhook receptor ikatu oñeñongatu moñe'ẽ-kuéra país ha aparato rehe, ha omoĩ mensaje kódigo moñe'ẽ'ỹ jave. Ne sistema oñeʼẽ mbaʼépa ha'e problema, ha app ome'ẽ evento-kuéra ha ndojuzgái. Upévare ne reglas ndéve porã ojeporu ojehecha.
Mba'e ñeñandu porã integración confiable-pe
- Guarda llave password-icha
- Llave ohechauka peteĩ jey añoite ha app-pe oñeñongatu digest rupi, upévare ndaikatúi jey ohechauka. Llave oñembotuicha jave, ehecha API kuatiarogue-gui ha ejapo pyahu. Revoke ohejáta opa pedido ojeporúva token vieja ha upéva oikóta enseguida.
- Eheʼi rate limit ha crédito
- Peteĩ llave ikatu omondo 120 pedido minutope. Pedido heta jave respuesta too-many-requests ohupyty. Crédito oñemboguejy jave, kódigo ojapo jave respuesta payment-required ohechauka error código ndaipóri crédito. App ndaikatúi ojeporu más crédito ojejapo, upévare planea batch-kuéra saldo rehe. Heta kódigo mokõi jey ojapo ndejapóiramo, saldo ndehe ehecha ojejapo mboyve.
- Emoneĩ HMAC firma ha timestamp
- Ejapo HMAC-SHA256 timestamp, punto ha cuerpo crudo rehe ne secreto ndive ha ehecha firma encabezado-pe. Eipe'a timestamp hasýva, peteĩ pedido ojoguáva noñemboguejyi hag̃ua, ha eiporu entrega identificador ojehechaukáva ojejapo jey.
- Ejapo endpoint ndehegui
- Webhook dirección HTTPS-pe oiko, credencial'ỹ, ha dirección público-pe oikuaa. Host local ha red privada refusado oĩ, ha redirect ndojeheka. Entrega ojavýva ojeha'ã mbovy jey espera-kuéra ojeaumenta ha ojehasa mboyve.
Mba'e oporandu API ha webhook-kuéra rehe
Mávapa plan omoĩ API?
Team plan. Llave ha webhook ojapo oikotevẽ upe plan, ha API ohupyty respuesta payment-required tembiapoha plan'ỹva ojeporúpe. Llave oñeñongatu downgrade rire, upévare oñepyrũ jeýta plan oikuaaporãva ojehu jave.
Mba'épa crédito omboguejy?
Peteĩ crédito oñemboguejy peteĩ kódigo API rupi ojapo jave. Ehecha, emoambue ha eipe'a kódigo-kuéra ndaikatúi crédito ojeporu. Ojapo jave validación ndoporãi, crédito ohupyty jeýta.
Mboýpa crédito oguerekóva tembiapoha oñepyrũvo?
Cuarenta, ha'e predeterminado valor peteĩ-peteĩ tembiapoha-pe base de datos-pe. App ndoguerekói página ojevende hag̃ua más, upévare ehecha saldo API kuatiarogue-pe térã cuenta pedido-gui import tuichave ndejapo rire.
Ikatu kódigo imagen-háicha API-gui ojehupyty?
Heẽ, SVG purá-háicha. Ejeporavo módulo tamaño peteĩ guive veinte peve, margen cero guive diez peve. Imagen blanco ha negro logo'ỹre, ha marandu tuichave QR kódigo-pe ndoikói jave, API ohechauka. Forma, sa'y térã logo-pe editor eiporu.
Mávapa evento-kuéra ikatu eiporavo?
Kódigo ojejapo, emoambue ha eipe'a, tapicha moñe'ẽ ojehecha ha landing kuatiarogue formulario ohupytyva. Bot-kuéra ha jehecha raẽ-kuéra ndoguerekói moñe'ẽ evento-kuéra, ha evento prueba ikatu omondo peteĩ webhook-pe.
Mba'épa oiko ne endpoint ojavýramo?
Entrega ojeha'ã mbovy jey, peteĩ espera ojeaumenta jave. Peteĩ-peteĩ intento-pe conexión tiempo límite 5 segundo ha lectura 10 segundo. Último fallo rire entrega ojehechauka ojavýva, ha webhook kuatiarogue ohechauka respuesta código ha última errore.
Ejapo nde kódigo peteĩha peteĩ minuto-pe
Editor repy'ỹ. Emoĩ cuenta eñongatu vove kódigo, ehecha moñe'ẽ térã emoambue destino upe rire.