API-endpointchecker

Optionele controles van de response

Laat een controle leeg als je die wilt overslaan. Een verborgen header of onleesbare body is niet te beoordelen en geldt niet als mislukte controle.

CORS bepaalt welke responses en headers deze pagina kan lezen. De bestemming ontvangt het verzoek en je IP-adres.

Status
Duur
ms
Bytes
Uiteindelijke URL na omleiding:
De preview stopte bij 1 MiB. Het endpoint heeft mogelijk meer gegevens teruggestuurd.

Resultaten van de responsecontroles

Afgeschermd rapport van één verzoek

De download bevat de methode, het afgeschermde endpoint, de uiteindelijke status, de tijdsduur en de controleresultaten. Het URL-pad en de query, verzoekheaders en body, responsebody en headerwaarden worden weggelaten.

Stuur vanuit je browser een GET-, HEAD-, POST-, PUT-, PATCH- of DELETE-verzoek en bekijk de uiteindelijke response. Je kunt optioneel een statuscode of bereik, een voor de browser zichtbare responseheader en een JSON-eigenschap controleren. Elke ingestelde controle krijgt de uitkomst Geslaagd, Mislukt of Niet te beoordelen. De tool toont de uiteindelijke status, de tijd tot de responseheaders, zichtbare headers en maximaal 1 MiB responsetekst. Het verzoek wordt pas verstuurd als je Verstuur verzoek kiest.

Een API-endpoint controleren

  1. 1

    Voer het verzoek in

    Voer een HTTP- of HTTPS-URL in en kies een methode. Voeg verzoekheaders of een body toe als het endpoint die nodig heeft. Bij GET en HEAD wordt de ingevulde body niet verstuurd.

  2. 2

    Stel optionele controles in

    Gebruik een code zoals 200, een bereik zoals 200-204 of een groep zoals 2xx. Je kunt ook een responseheader en een JSON-pad opgeven, eventueel met een verwachte waarde. Laat een controle leeg om die over te slaan.

  3. 3

    Verstuur en bekijk het resultaat

    Kies één keer Verstuur verzoek. Bekijk de uiteindelijke status en elke controle-uitkomst. Een verborgen header, onleesbare response of onvolledige JSON-body kan tot Niet te beoordelen leiden.

  4. 4

    Sla een afgeschermd rapport op

    Download voor deze controle een tekst- of JSON-rapport. Het vermeldt de origin van het endpoint, methode, uiteindelijke status, tijdsduur en uitkomsten, maar laat URL-pad en query, verzoekwaarden en response-inhoud weg.

Voorbeeld van een responsecontrole

Stel dat je eigen endpoint GET https://api.example.com/health status 200, een voor de browser zichtbare header Content-Type: application/json en {"status":"ready"} teruggeeft. Dan kun je het volgende invullen:

Optioneel veld Voorbeeld Wat het controleert
Verwachte statuscodes 200, 204 of 2xx Of de uiteindelijke status in de opgegeven verzameling valt.
Naam van responseheader Content-Type Of de browser deze header kan zien.
Verwachte headerwaarde application/json Of de zichtbare waarde exact overeenkomt. Laat leeg als je alleen de zichtbaarheid wilt controleren.
Pad naar JSON-eigenschap $.status Of de eigenschap voorkomt in een volledig gelezen JSON-response.
Verwachte JSON-waarde "ready" Of de verwerkte JSON-waarde overeenkomt. Laat leeg als je alleen op bestaan wilt controleren.

Voer een JSON-waarde in volgens JSON-syntaxis: true voor een booleaanse waarde, 42 voor een getal en "ready" voor een tekenreeks. Paden beginnen bij $ en ondersteunen eigenschappen en array-indexen, bijvoorbeeld $.data.items[0].id. Ze voeren geen script uit en ondersteunen geen filters. Ontbreekt een eigenschap in leesbare JSON, dan mislukt die controle. Een ontbrekende of door CORS verborgen header is Niet te beoordelen, omdat de browser die twee gevallen niet kan onderscheiden.

Wat de uitkomst betekent

Uitkomst Betekenis
Geslaagd De leesbare uiteindelijke response voldeed aan die specifieke verwachting.
Mislukt De leesbare uiteindelijke response week af van de verwachting of de gevraagde JSON-eigenschap ontbrak.
Niet te beoordelen De browser kon de uitkomst niet vaststellen. Bijvoorbeeld omdat de response onleesbaar was, een header ontbrak of verborgen was, of de JSON-body leeg, onvolledig of ongeldig was.

De timer stopt wanneer de responseheaders aankomen en meet niet de download van de hele body. Het verzoek verloopt na 15 seconden. Verzoekbody’s zijn beperkt tot 1 MiB en de responsepreview stopt na 1 MiB. Met een afgekapt voorbeeld kun je de uitkomst van een JSON-eigenschap niet vaststellen. HEAD- en 204-responses hebben geen body om te onderzoeken; een JSON-controle is dan Niet te beoordelen. De tool volgt redirects en toont de uiteindelijke URL, maar toont niet elke tussenstap en herhaalt het verzoek niet automatisch. CORS-regels kunnen voorkomen dat de browser een response leest, ook als het endpoint het verzoek heeft ontvangen. De browser kan bovendien vóór de gekozen methode een CORS-preflight sturen.

Alleen voor de browser vrijgegeven responseheaders zijn te bekijken. Voor een aangepaste header moet het endpoint die mogelijk opnemen in Access-Control-Expose-Headers. Een header die deze pagina niet ziet, kan op de server ontbreken of door CORS verborgen zijn. Gebruik serverlogs of een geschikte API-client als je dat onderscheid moet maken.

Veelgestelde vragen

Mislukt betekent dat een voor de browser leesbare response afwijkt van je verwachting. Niet te beoordelen betekent dat de browser geen uitkomst kan vaststellen. Hij kan bijvoorbeeld niet zien of een onzichtbare responseheader ontbreekt of door CORS verborgen is. Ook JSON in een lege, onleesbare of afgekapt body kan hij niet controleren.

Je kunt een Authorization-header invullen als het endpoint dit browserverzoek via CORS toestaat. De checker stuurt geen browsercookies of andere automatisch toegevoegde inloggegevens mee. Je headerwaarde gaat rechtstreeks naar de bestemming; gebruik daarom alleen gegevens voor een endpoint dat je vertrouwt.

Je browser stuurt het verzoek rechtstreeks naar de bestemming. Die ontvangt het verzoek en je IP-adres. De ingevoerde URL, verzoekheaders en inhoud gaan niet via de servers van deze site en verschijnen ook niet in de URL van de toolpagina. Van het endpoint blijft in het afgeschermde rapport de oorsprong staan; de rest van de URL, de verzoekheaders en de inhoud ontbreken. Om tussen stappen te wisselen, slaat de checker je invoer kort op in de sessieopslag van dit tabblad. Het opgeslagen record wordt maximaal vijf minuten geaccepteerd en verwijderd zodra het is gelezen, wanneer je opnieuw begint of na een controle. Scripts op dezelfde site kunnen het record lezen zolang het bestaat. Als je browser opslag blokkeert, kun je het verzoek vanaf dezelfde pagina versturen.

Voor de huidige controle wordt één tekst- of JSON-rapport gemaakt. Het bevat de origin van het endpoint, methode, uiteindelijke status, tijd tot de responseheaders, ontvangen bytes, aanduidingen voor redirects en afkapping en de controle-uitkomsten. URL-pad, query, fragment, verzoekheaders en hun waarden, verzoekbody, responseheaders en hun waarden en responsebody ontbreken. Bekijk het bestand vóór je het deelt, want de origin en uitkomsten kunnen je dienst alsnog herkenbaar maken.

De timer begint vlak voordat de browser Fetch start en stopt zodra de uiteindelijke responseheaders aankomen. Browser- en netwerkvertraging en toegestane redirects tellen mee, maar het lezen van de body niet. Serverlogs kunnen een ander tijdsinterval meten.

Nee. Er vindt alleen een controle plaats als je Verstuur verzoek kiest. De tool plant geen controles, herhaalt ze niet automatisch en bewaakt het endpoint niet. Een CORS-preflight of gevolgde redirect kan wel extra netwerkverzoeken toevoegen aan één controle.

Gerelateerde tools

Tool beschikbaar in andere talen