Sisällön saatavuus ja lähdeviittaukset
Julkiset artikkelit, selkeät lähdeviitteet ja pysyvä linkki alkuperäiseen.
Lue ja löydä
Artikkelisivut sisältävät luettavissa olevan tekstin ja lähdeviitteet, eikä julkisten artikkelien lukeminen vaadi JavaScriptiä tai tiliä. Löydät koko kokoelman artikkeliarkistosta, ensisijaiset URL-osoitteet sivukartasta, uusimmat 50 artikkelia RSS-syötteestä ja tekstihakemiston llms.txt-tiedostosta.
Artikkelirajapinta vain lukukäyttöön
Julkisten artikkelien vienti ei edellytä API-avainta. Lähetä GET-pyyntö osoitteeseen /api/public/articles/ARTICLE-SLUG saadaksesi JSON-muodon tai lisää loppuun ?format=markdown saadaksesi Markdown-muodon. Nämä muodot tuotetaan samasta tallennetusta artikkelista kuin lukusivu, ja niissä säilyvät otsikot, luettelot, linkit, kuvien tekijätiedot ja toimitukselliset ilmoitukset.
Kokeile JSON-esimerkkiä, sen Markdown-versiota ja alkuperäistä artikkelia.
JSON sisältää url-kentän (ensisijainen lukusivu), otsikon, kuvauksen, kirjoittajan, julkaisijan, kielen, aiheen, publishedAt-, modifiedAt-, body.format- ja body.text-kentät sekä artikkelin links-kentän. Linkit ovat tekstistä löytyviä viitteitä; niiden mukanaolo ei tarkoita, että jokainen linkitetty sivu tukisi jokaista väitettä. Kaikki päivämäärät ovat ISO 8601 -muodossa.
Listaa artikkelit ja seuraa päivityksiä
Pyydä /api/public/articles?limit=24, jos haluat vain metatiedot. Oletusraja on 6 ja enimmäisraja 24. Käytä seuraavaa sivua varten parametria page=2. Valinnainen topic hyväksyy aiheen URL-tunnisteen ja author positiivisen kirjoittajan ID:n. Vastaus sisältää kentät docs, hasNextPage, totalPages ja nextAfter.
Jatka sivutusta välittämällä palautettu nextAfter.at parametrina afterAt ja nextAfter.id parametrina afterId, molemmat URL-koodattuina. Pidä suodattimet ja raja samoina. Jatka niin kauan kuin hasNextPage on tosi. Metatietojen listaaminen ei anna pääsyä rajoitettujen artikkelien sisältöteksteihin.
Käyttöoikeuksien rajat ja ajantasaisuus
Koko tekstin palauttava päätepiste on käytettävissä vain julkaistuille julkisille artikkeleille, joiden julkaisuajankohta on koittanut. Tuntemattomat artikkelit, luonnokset, ajastetut artikkelit sekä tiliä tai jäsenyyttä edellyttävien artikkelien sisältötekstit palauttavat tilakoodin 404. Virheelliset muodot tai listausparametrit palauttavat tilakoodin 400. Päätepiste hyväksyy GET- ja HEAD-pyynnöt; kirjoittavia metodeja ei tueta. Sisäänkirjautuminen ei avaa vientioikeutta.
Viennit luodaan pyynnöstä, ja niissä käytetään Cache-Control: no-store -asetusta, jotta korjattu teksti ja käyttöoikeusmuutokset tarkistetaan uudelleen. Niiden HTTP-vastauksen Link-otsake osoittaa ensisijaisen HTML-sivun. Nouda sisältöä peräkkäisin pyynnöin, vältä toistuvia massalatauksia ja yritä uudelleen viiveen jälkeen, jos palvelimella ilmenee tilapäinen virhe.
Tekijätiedot, lähteet ja uudelleenkäyttö
Kun viittaat artikkeliin, käytä sen ensisijaista URL-osoitetta, otsikkoa, ilmoitettua kirjoittajaa ja julkaisupäivää; merkitse myös muokkauspäivä, jos sillä on merkitystä viittauksesi kannalta. Säilytä ero Koraanin kohdan, käännöksen, linkitetyn lähteen ja julkaisun oman selityksen välillä. Toimituksen nimissä julkaistut tekijätiedot viittaavat tiimeihin eivätkä osoita yksittäisten henkilöiden pätevyyttä oppineina.
Omakohtaiset pohdinnat ja käytännön oppaat eivät korvaa pätevän asiantuntijan antamaa uskonnollista opetusta. Tulkinnalliset ja opilliset tekstit noudattavat toimitusperiaatteidemme arviointivaatimuksia. Korjaukset ja olennaiset sidonnaisuudet kuuluvat artikkelin yhteyteen myös otteissa.
Julkinen saatavuus ei muuta tekijänoikeuksia eikä anna lupaa julkaista kokonaisia artikkeleita uudelleen tai poistaa tekijätietoja. Jaa linkkejä ja käytä lain sallimia lainauksia tekijän mainiten käyttöehtojemme mukaisesti. Korjaus- ja lupapyynnöt voi tehdä Ohjeen kautta.