Ga naar hoofdinhoud

Snelle start · Je eerste verzoek in drie stappen

Doel: een werkend HTTP-verzoek van nul opbouwen. Als je de hoofdlijn 'Groep → Omgeving → Verzoek' begrijpt, is elk ander protocol slechts een ander protocol en een andere Pre-URL.


Stap 1: maak een groep, koppel een omgeving​

In Quick Request is de omgeving aan de groep gekoppeld, en alle verzoeken in de groep delen die.

  1. Maak een nieuwe groep aan (bijv. Mijn eerste groep).
  2. Koppel een omgeving aan de groep. Heb je er nog geen, maak dan eerst een omgeving aan (bijv. Lokaal).

Waarom die extra laag? Omdat je, wanneer een module verhuist tussen dev / staging / productie, alleen de omgeving wilt bewerken — niet tientallen verzoeken.


Stap 2: vul de Pre-URL in de omgeving in​

Een omgeving bewaart één basisadres per protocol. Om HTTP te versturen, vul je de http-invoer in:

ProtocolregelVoorbeeldbasisadresOpmerkingen
HTTPhttp://127.0.0.1:18080Gebruik https:// om TLS aan te zetten
WebSocketws://127.0.0.1:18085Gebruik wss:// om TLS aan te zetten
gRPCgrpc://127.0.0.1:18089Gebruik grpcs:// om TLS aan te zetten
MQTTmqtt://127.0.0.1:18884Gebruik mqtts:// om TLS aan te zetten

⚠️ De gemakkelijkste valkuil: tot welk protocol een basisadres behoort, wordt bepaald door de scheme aan het begin van de URL, niet door in welke regel je het typte. Een WebSocket-basisadres moet worden geschreven als ws://… of wss://…; typ je per ongeluk https://…, dan wordt het als HTTP behandeld, vindt het WebSocket-verzoek geen basisadres en faalt. Houd de protocolregel en de scheme consistent.

(De poorten zoals 18080 hierboven komen van de voorbeeldtestserver; vervang ze door je echte adressen wanneer je je eigen API's test.)


Stap 3: maak een verzoek, vul alleen het padfragment in, verstuur​

Maak een verzoek in de groep:

  1. Protocol: HTTP; Methode: GET.
  2. URL — vul alleen het padfragment in: /echo (niet de volledige host — de host wordt al geleverd door de http-Pre-URL van de omgeving).
  3. Tik op Verzenden.

Je ziet /echo exact teruggeven wat je stuurde. Wat er werkelijk over de draad ging, was http://127.0.0.1:18080/echo.


Het werkt — wat nu?​

  • Wil je begrijpen 'waarom alleen /echo' en 'waar {{x}} vandaan komt' → concepts
  • Wil je verzoeken ondertekenen vóór verzending / antwoorden ontsleutelen → scripting
  • Wil je het recept 'inloggen voor token, automatisch toevoegen voor de hele groep' kopiëren → recipes
  • Van protocol wisselen (WS/TCP/UDP/gRPC/MQTT) → de bijbehorende protocolpagina (zie de index)