Tarkista API-sivutus

Saitko kaikki odotetut sivut?

200-vastaus voi sisältää vain ensimmäisen sivun. Sivutus voi käyttää numeroa, siirtymää, kohdistinta tai jatkolinkkiä. Menetelmä tekee tarkistuksesta toistettavan; palvelun dokumentaatio määrää mekanismin.

1. Lukitse rajaus

   Säilytä kysely, suodattimet, versio ja järjestys. Selvitä, laskeeko kokonaismäärä tietueita, arvioita vai eri kohteita. Vertaa samoja suodattimia.

2. Seuraa jatkoa

   Lue annettu jatkolinkki tai kohdistin. Kirjaa siirtymät ja tunnista aiemmin käytetyt jatkot. Älä keksi osoitteita palvelun antamien tilalle.

3. Täsmäytä määrät

   Laske tietueet ja yksilölliset tunnisteet erikseen. Päällekkäiset sivut kasvattavat tietuemäärää. Säilytä toistot versioiden tutkimista varten ennen poistoa.

4. Kirjaa lopetus

   Merkitse loppu, keruuraja, virhe tai keskeytys. Käytä tilannekuvaa, jos mahdollista, tai ilmoita tietojen muuttuminen. Jatka samoilla suodattimilla.

Tilanteet ja päätökset

Tyypillisiä tilanteita tarkistuksen suunnitteluun. Ne eivät kuvaa toteutettuja toimeksiantoja tai todellisia havaintoja.

Säilytettävä näyttö

• Kysely, suodattimet ja versio
• Siirtymät ja vastaukset
• Tietueiden ja eri kohteiden määrät
• Lopetussyy ja jatkoehdot

Viralliset lähteet

• GitHub — REST pagination
• IETF — Web Linking, RFC 8288

Liittyvät lähdesivut

• data.gouv.fr
• Eurostat · Data Browser
• Crossref Metadata Search
• Companies House

Aiheeseen liittyvät protokollat

• Kysy julkista APIa ja säilytä todennettava poiminta
• Säilytä julkisen aineiston toistettava versio
• Tarkista liitos ennen kahden tiedoston yhdistämistä

Tarkistukset ennen johtopäätöstä

• Ovatko suodattimet vakaat?
• Ovatko jatkot yksilöllisiä?
• Onko toistot selitetty?
• Onko lopetussyy selvä?

Keruuloki, joka erottaa teknisen onnistumisen, havaitun kattavuuden ja keskeytyksen.