API fyrir forritara

Búðu til verkefni úr þínu eigin kerfi

Ein POST-fyrirspurn fyrir hverja tegund verkefnis. Sendu efnið þitt sem JSON og fáðu til baka verkefni í Puzzel.org-aðgangnum þínum og vefslóð sem þú getur afhent leikmönnum eða sett inn í iframe.

Grunnslóð: https://puzzel.org/api/public/v1
Auðkenning: Lykill + netfang í meginmáli
Endapunktar: 38 tegundir verkefna
Kvóti: 10 verkefni á dag

Fyrsta fyrirspurnin þín

Ekkert að setja upp og enga tengimyndun þarf: sendu JSON-meginmál með lyklinum þínum, netfanginu þínu og efninu þínu. Svarið inniheldur lykil nýja verkefnisins og vefslóðina sem það er spilað á.

POST crossword

curl -X POST https://puzzel.org/api/public/v1/crossword \
  -H "Content-Type: application/json" \
  -d '{
  "account_api_key": "YOUR_API_KEY",
  "email": "you@example.com",
  "title": "Crossword",
  "language": "is",
  "items": [
    {
      "answer": "BANANA",
      "description": "A long yellow fruit",
      "type": "text"
    },
    {
      "answer": "CHERRY",
      "description": "A small red stone fruit",
      "type": "text"
    },
    {
      "answer": "MELON",
      "description": "Big, green outside, sweet inside",
      "type": "text"
    }
  ]
}'

Tókst

{
  "success": true,
  "id": "-Nq8sample_activity_key",
  "url": "https://puzzel.org/en/crossword/embed?p=-Nq8sample_activity_key",
  "message": "Crossword created successfully"
}

Sérhvert dæmi á þessari síðu er heil, keyranleg fyrirspurn. Skiptu út fyrir þinn eigin lykil og efni og hún virkar eins og hún er.

Auðkenning

Það eru engin headers og enginn bearer token. Bæði auðkennin ferðast í JSON-meginmáli hverrar fyrirspurnar, og lykillinn er aðeins samþykktur fyrir þann aðgang sem netfangið tilheyrir.

Reitur	Tegund	Hvað hann gerir
`account_api_key` nauðsynlegt string	string	API-lykill aðgangsins þíns. Hann fer í meginmálið, ekki í header.
`email` nauðsynlegt string	string	Netfangið sem Puzzel.org-aðgangurinn þinn skráir sig inn með. Lykillinn er aðeins gildur ásamt því.

Lykillinn þinn er í aðgangshluta stjórnborðsins þíns, á bak við Sýna.

Skrá inn

API-lyklar eru afhentir þegar áskrift hefst, svo ókeypis aðgangur hefur ekki fengið sinn ennþá.

Skoða áskriftarleiðirnar

Farðu með lykilinn eins og lykilorð. Hann býr til og skrifar yfir verkefni í aðgangnum þínum, svo geymdu hann á vefþjóninum og haltu honum utan alls sem vafri getur lesið.

Meginmál fyrirspurnarinnar

Sérhver endapunktur tekur við sömu fimm reitunum. Það sem er breytilegt er content-reiturinn undir þeim: flestir taka fylki af items, sumir taka eina setningu eða eina mynd, og Sudoku tekur ekkert.

Reitur	Tegund	Hvað hann gerir
`account_api_key` nauðsynlegt string	string	API-lykill aðgangsins þíns. Hann fer í meginmálið, ekki í header.
`email` nauðsynlegt string	string	Netfangið sem Puzzel.org-aðgangurinn þinn skráir sig inn með. Lykillinn er aðeins gildur ásamt því.
`title` valfrjálst string	string	Heitið sem verkefnið fær í stjórnborðinu þínu. Sleppirðu því notar endapunkturinn sitt eigið sjálfgefna heiti.
`language` valfrjálst string	string	Ákveður aðeins málsvæðið í vefslóðinni sem þú færð til baka — þýðir ekki neitt af innihaldinu sem þú sendir. Orðaleit les þennan reit líka til að skipta fyllistöfunum sínum yfir í arabísku þegar gildið er "ar". Sjálfgefið: "en"
`activity_key` valfrjálst string	string	Sleppirðu því býrðu til nýtt verkefni. Sendirðu lykil verkefnis sem þú átt nú þegar er það verkefni endurbyggt í staðinn.

settings er hlutur með valkostum fyrir hvern endapunkt. Hvaða valkosti hver endapunktur les er talið upp hér fyrir neðan; allt annað sem þú setur þar er hunsað.

Það sem kemur til baka

Fyrirspurn sem heppnast svarar með 200 og skilar lykli nýja verkefnisins og vefslóðinni sem það er spilað á. Allt annað svarar með success sett á false og einum villustreng.

Tókst

{
  "success": true,
  "id": "-Nq8sample_activity_key",
  "url": "https://puzzel.org/en/crossword/embed?p=-Nq8sample_activity_key",
  "message": "Crossword created successfully"
}

Mistókst

{
  "success": false,
  "error": "Invalid Email or API Key"
}

Vefslóðin sem þú færð til baka er innfellingarútgáfan. Skiptu embed út fyrir play til að opna hana á heilli síðu, eða fyrir build til að opna hana í ritlinum — lykillinn eftir p= helst óbreyttur.

Að búa til eða uppfæra

Sendirðu activity_key er verkefnið á bak við hann endurbyggt á sínum stað: efni þess er skipt út, heiti þess og útgáfustimpill eru uppfærð, og lykillinn sjálfur helst óbreyttur — svo tenglar og innfellingar sem þú hefur þegar deilt halda áfram að virka. Niðurstöður, möppustaðsetning og allar stillingar sem endapunkturinn skrifar ekki sjálfur halda sér óbreyttar.

activity_key

{
  "account_api_key": "YOUR_API_KEY",
  "email": "you@example.com",
  "activity_key": "-Nq8sample_activity_key",
  "title": "Fruit crossword, week 2",
  "items": [
    {
      "answer": "BANANA",
      "description": "A long yellow fruit",
      "type": "text"
    },
    {
      "answer": "CHERRY",
      "description": "A small red stone fruit",
      "type": "text"
    },
    {
      "answer": "MELON",
      "description": "Big, green outside, sweet inside",
      "type": "text"
    }
  ]
}

title er beitt við hverja uppfærslu, sjálfgefna gildið meðtalið — sleppirðu því er verkefnið endurnefnt í sjálfgefið heiti þess endapunkts.
Stillingablokkirnar sem endapunktur skrifar sjálfur eru endurskrifaðar frá grunni, svo uppfærsla núllstillir þær líka á gildin sem þú sendir, eða á sjálfgefin gildi endapunktsins.
Þú getur aðeins uppfært verkefni sem þinn eigin aðgangur á. Lykill einhvers annars svarar með 403.
Uppfærsla kostar það sama og að búa til nýtt: eina fyrirspurn af kvóta dagsins.

Tíðnitakmörk

10 verkefni á hvern aðgang á dag

Sérhver fyrirspurn sem heppnast telur, hvort sem hún býr til eða uppfærir. Farirðu yfir mörkin svarar næsta fyrirspurn með 429 þar til teljarinn er hreinsaður.

Teljarinn er hreinsaður einu sinni á dag af tímasettu verki, ekki á fljótandi 24 klukkustunda glugga.

Villur

Villur berast alltaf sem JSON með sömu tveimur reitunum, aldrei sem HTML-síða. Villustrengurinn er skrifaður til að fólk geti lesið hann — hann nefnir reitinn eða mörkin sem brugðust.

Staða	Hvað hún þýðir
`400` Bad Request	Eitthvað í meginmálinu vantar, er rangt sniðið eða utan marka. Skilaboðin nefna reitinn.
`401` Unauthorized	Netfangið er óþekkt, eða lykillinn tilheyrir ekki þeim aðgangi.
`403` Forbidden	activity_key sem þú sendir tilheyrir öðrum aðgangi.
`429` Too Many Requests	Kvóti dagsins er búinn. Hann hreinsast einu sinni á dag.
`500` Server Error	Smiðjan gat ekki búið til þraut úr því sem þú sendir — oftast of fá orð, eða orð sem er ekki hægt að raða saman.

Endapunktar

Ein slóð fyrir hverja tegund verkefnis, allar POST, allar undir sömu grunnslóðinni. Hver þeirra sýnir efnið sem hún þarf, stillingarnar sem hún les og fyrirspurn sem þú getur keyrt.

Orð og stafir

Krossgáta

Fléttar svörin þín saman í reitanet og númerar skýringarnar fyrir þig.

POST /api/public/v1/crossword 2 til 80 í items

Efni

Fylki af orðum. Hver færsla parar svarið við skýringuna sem vísar á það.

Fellur til baka á heitið “Crossword API”

Vert að vita

Svör sem eru styttri en tveir stafir eru felld út áður en reitanetið er búið til, og að minnsta kosti tvö verða að lifa það af.
Svör eru sett í hástafi og smiðjan fær tuttugu tilraunir til að koma þeim fyrir. Ef hún getur ekki komið fyrir einu einasta orði svarar fyrirspurnin með 500.

Stillingar sem hann les

Reitur	Tegund	Hvað hann gerir
`hidden_solution` valfrjálst í settings string	string	Valfrjálst bónusorð. Stafir þess eru merktir í reitum fullbúna reitanetsins, svo leikmenn geti safnað þeim þegar krossgátan er leyst, og þess vegna þurfa allir stafir þess að koma fyrir í svörunum.

Dæmi um fyrirspurn

POST crossword

curl -X POST https://puzzel.org/api/public/v1/crossword \
  -H "Content-Type: application/json" \
  -d '{
  "account_api_key": "YOUR_API_KEY",
  "email": "you@example.com",
  "title": "Crossword",
  "language": "is",
  "items": [
    {
      "answer": "BANANA",
      "description": "A long yellow fruit",
      "type": "text"
    },
    {
      "answer": "CHERRY",
      "description": "A small red stone fruit",
      "type": "text"
    },
    {
      "answer": "MELON",
      "description": "Big, green outside, sweet inside",
      "type": "text"
    }
  ]
}'

Tókst

{
  "success": true,
  "id": "-Nq8sample_activity_key",
  "url": "https://puzzel.org/en/crossword/embed?p=-Nq8sample_activity_key",
  "message": "Crossword created successfully"
}

Reitur	Tegund	Hvað hann gerir
`hidden_solution` valfrjálst í settings string	string	Afgangsstafirnir mynda þetta. Sért þessi stilling notuð segir hún smiðjunni líka að koma lausninni fyrir fyrst, frekar en að troða inn eins mörgum orðum og hún getur.
`directions` valfrjálst í settings string[]	string[]	Í hvaða áttir orð mega liggja. Sleppirðu þessu liggja orð aðeins til austurs, suðausturs og suðurs. Eitt af `westeastnorthsouthnorthwestnortheastsouthwestsoutheast` Sjálfgefið: ["east", "southeast", "south"]
`template` valfrjálst í settings string	string	Sker reitanetið í ákveðið form í stað þess að láta það vera ferkantað. Eitt af `squarecirclecrossdiamondpyramidsmileystarcross_plus`

Reitur	Tegund	Hvað hann gerir
`theme` valfrjálst í settings string	string	Gátan sem birtist fyrir ofan reitanetið. Sleppirðu henni sjá leikmenn heitið.
`spangram` valfrjálst í settings string	string	Orðið eða orðasambandið sem nefnir þemað og liggur þvert yfir borðið frá einni hlið að hinni.

Reitur	Tegund	Hvað hann gerir
`list_match_mode` valfrjálst í settings string	string	Hvort nafn telst um leið og það er skrifað, eða aðeins þegar ýtt er á Enter. Eitt af `while_typingon_enter` Sjálfgefið: "while_typing"
`list_slot_hint` valfrjálst í settings string	string	Hvað tómur reitur gefur upp: ekkert, lengd nafnsins, fyrsta staf þess, eða ábendinguna sem þú skrifaðir. Eitt af `nonelengthfirst_letterhint` Sjálfgefið: "none"
`list_arrange` valfrjálst í settings string	string	Einn dálkur fyrir hvern hóp, eða einn listi. Eitt af `groupsone_list` Sjálfgefið: "groups"
`list_allow_give_up` valfrjálst í settings boolean	boolean	Sýnir hnapp til að gefast upp sem endar umferðina og afhjúpar það sem vantaði. Sjálfgefið: false

Reitur	Tegund	Hvað hann gerir
`mode` valfrjálst í settings string	string	Hvað fyllir reitina: atriðin þín, atriðin þín dregin út frá vísbendingunni, eða hreinar tölur (sem þurfa engin items). Eitt af `itemscluesnumbers` Sjálfgefið: "items"
`rows` valfrjálst í settings number	number	Raðir á hverju spjaldi, 2 til 5. Sjálfgefið: 3
`columns` valfrjálst í settings number	number	Dálkar á hverju spjaldi, 2 til 5. Sjálfgefið: 3
`highest_number` valfrjálst í settings number	number	Í talnahamnum eru spjöldin fyllt frá 1 upp í þessa tölu, að hámarki 100. Eiginleiki áskriftarleiðar: án hennar er hún áfram 50. Sjálfgefið: 50

Reitur	Tegund	Hvað hann gerir
`instructions` valfrjálst í settings string	string	Spurningin eða gátan sem kóðinn svarar, sýnd með spjöldunum.
`force_solution_in_correct_order` valfrjálst í settings boolean	boolean	Takkarnir verða að vera slegnir inn í réttri röð. Slökkt þýðir að hvaða röð sem er af réttu tökkunum opnar lásinn. Sjálfgefið: false
`randomize_order` valfrjálst í settings boolean	boolean	Hver leikmaður fær takkana í stokkaðri röð. Sjálfgefið: true

Reitur	Tegund	Hvað hann gerir
`number_of_tiles` valfrjálst í settings number	number	Hversu marga reiti borðið hefur. Milli 10 og 75. Sjálfgefið: 30
`game_mode` valfrjálst í settings string	string	Hvort leikmenn keppa að marklínu eða safna hlutum á leiðinni. Eitt af `race_to_finishcollect_items` Sjálfgefið: "race_to_finish"

Reitur	Tegund	Hvað hann gerir
`maze_width` valfrjálst í settings string	string	Hvernig salirnir raðast: einn dálkur, ferningur, eða breiðara. Eitt af `narrownormalwide` Sjálfgefið: "normal"
`maze_corridors` valfrjálst í settings string	string	Hversu mikið völundarhús liggur á milli tveggja spurninga. Eitt af `shortnormallong` Sjálfgefið: "normal"
`maze_fog` valfrjálst í settings string	string	Sýna allt völundarhúsið, eða aðeins það sem leikmaðurinn hefur komið nálægt. Eitt af `offnear` Sjálfgefið: "off"
`maze_wrong_door_pause` valfrjálst í settings string	string	Hversu lengi dyrnar haldast lokaðar eftir rangar dyr. Eitt af `noneshortlong` Sjálfgefið: "short"
`maze_walk_there` valfrjálst í settings boolean	boolean	Býður upp á hnapp sem gengur með spilapeðið í næsta sal. Sjálfgefið: false
`maze_seed` valfrjálst í settings string	string	Fræið sem völundarhúsið er búið til úr. Sama fræ og sömu spurningar gefa sama völundarhús; sleppirðu því er nýtt dregið.

Reitur	Tegund	Hvað hann gerir
`jeopardy_buzzer_mode` valfrjálst í settings string	string	Hver spilar hvernig: leikstjórinn stýrir úr stjórnskjánum, leikmenn svara úr símunum sínum, eða hver leikmaður spilar borðið einn. Eitt af `hostphonessolo` Sjálfgefið: "host"
`jeopardy_contestants` valfrjálst í settings string	string	Hvort stjórnskjárinn talar um lið eða leikmenn. Eitt af `teamsplayers` Sjálfgefið: "teams"
`jeopardy_value_step` valfrjálst í settings number	number	Hvers virði röð er: skýring er þetta margfaldað með röðinni sem hún er í. Frá 50 til 500, í skrefum af 50. Sjálfgefið: 100
`jeopardy_answer_time` valfrjálst í settings number	number	Sekúndur til að svara eftir að skýring er opnuð, allt að 300. 0 þýðir enginn tímamælir. Sjálfgefið: 20
`jeopardy_wrong_answer_costs` valfrjálst í settings boolean	boolean	Rangt svar dregur virði skýringarinnar frá stigunum. Sjálfgefið: false
`jeopardy_reveal_on_timeout` valfrjálst í settings boolean	boolean	Borðið sýnir svarið sjálft þegar tíminn rennur út. Sjálfgefið: false
`jeopardy_require_question_form` valfrjálst í settings boolean	boolean	Minnir leikmenn á að svara á formi spurningar. Sjálfgefið: false

Reitur	Tegund	Hvað hann gerir
`video_url` nauðsynlegt í settings string	string	Myndbandið: YouTube-, Vimeo- eða Bunny Stream-síða, eða bein slóð á mp4-, webm- eða mov-skrá.
`video_duration` valfrjálst í settings number	number	Lengd myndbandsins í sekúndum. Sé hún gefin upp er sprettigluggi eftir lok myndbandsins hafnað.

Reitur	Tegund	Hvað hann gerir
`sentence` nauðsynlegt string	string	Setningin sem á að dulrita. Leikmenn ráða hana staf fyrir staf.
`helpers` valfrjálst í settings string	string	Hvaða stafir eru gefnir frítt sem leið inn í þrautina: engir, þeir algengustu, sérhljóðarnir, eða þeir sem þú telur upp. Eitt af `nonemost_commonvowelscustom` Sjálfgefið: "none"
`character_list` valfrjálst í settings string	string	Stafrófið sem dulmálið er byggt á. Sé það haft tómt velur dulritunin sitt eigið.
`extra_letters` valfrjálst í settings string	string	Stafirnir sem eru gefnir þegar helpers er "custom". Hunsað fyrir aðra hjálparhami.
`hide_unused_characters` valfrjálst í settings boolean	boolean	Sleppir stöfum sem setningin notar aldrei úr lyklinum. Sjálfgefið: false

Reitur	Tegund	Hvað hann gerir
`sentence` nauðsynlegt string	string	Setningin sem leikmenn afhjúpa með því að leysa reikningsdæmin.
`difficulty_level` valfrjálst í settings number	number	Hæsta svar sem reikningsdæmi má hafa. Eitt af `20501001000` Sjálfgefið: "100"
`operators` valfrjálst í settings string[]	string[]	Hvaða reikniaðgerðir mega koma fyrir. x er margföldun, : er deiling. Eitt af `+-x:` Sjálfgefið: ["+", "-", "x", ":"]
`max_operations` valfrjálst í settings number	number	Hversu margar aðgerðir eitt reikningsdæmi má tengja saman. Eitt af `123` Sjálfgefið: 1
`number_difficulty` valfrjálst í settings number	number	Takmarkar einstakar tölur innan í reikningsdæmi. Allt frá 5 upp í 1000. Sjálfgefið: 100

Reitur	Tegund	Hvað hann gerir
`size` valfrjálst í settings string	string	Stærð eins reits, skrifuð sem raðir sinnum dálkar — 3x3 gefur hið klassíska 9x9 reitanet. Endapunkturinn athugar aðeins að þetta séu tvær tölur, svo haltu þig við þær stærðir sem ritillinn býður upp á. Eitt af `2x22x33x33x44x4` Sjálfgefið: "3x3"
`difficulty_level` valfrjálst í settings string	string	Hversu margar tölur eru skildar eftir á borðinu til að byrja með. Eitt af `easynormalhard` Sjálfgefið: "normal"

Reitur	Tegund	Hvað hann gerir
`sentence` nauðsynlegt string	string	Setningin sem á að fela: tilvitnun, málsháttur, lykilsetning. Að hámarki 120 stafir og tölustafir.
`columns` valfrjálst í settings number	number	Hversu breitt borðið er, frá 8 til 18. Mjórra borð raðar fleiri stöfum í hvern dálk og er erfiðara. Sjálfgefið: 14
`helpers` valfrjálst í settings string	string	Hvaða stafir eru eftir í reitanetinu sem leið inn: engir, þeir algengustu, sérhljóðarnir, eða þeir sem þú telur sjálf/ur upp. Eitt af `nonemost_commonvowelscustom` Sjálfgefið: "none"
`extra_letters` valfrjálst í settings string	string	Stafirnir sem eru gefnir þegar helpers er "custom".

Reitur	Tegund	Hvað hann gerir
`tables` valfrjálst í settings number[]	number[]	Töflurnar sem á að æfa. Sleppirðu þessu eru það 1 til 10; 11 eða 12 gerir reitanetið 12 sinnum 12. Eitt af `123456789101112`
`order` valfrjálst í settings string	string	Hvort raðir og dálkar liggja í réttri röð eða eru stokkaðir. Eitt af `ascendingshuffled` Sjálfgefið: "ascending"
`picture` valfrjálst í settings string	string	Myndin sem rétt svör mála. Eitt af `sailboatheartrockettreecatfishflowerhouse` Sjálfgefið: "sailboat"
`players_choose_tables` valfrjálst í settings boolean	boolean	Leyfir hverjum leikmanni að velja hverja af töflunum hann æfir. Sjálfgefið: false
`fill_same_sums` valfrjálst í settings boolean	boolean	Eitt rétt svar fyllir alla reiti með sama reikningsdæmi. Sjálfgefið: true

Reitur	Tegund	Hvað hann gerir
`story` valfrjálst í settings string	string	Bakgrunnssagan sem birtist fyrir ofan vísbendingarnar.
`difficulty` valfrjálst í settings string	string	Hvaða tegundir af vísbendingum smiðjan má nota. Eitt af `easymediumhard` Sjálfgefið: "easy"
`hints` valfrjálst í settings boolean	boolean	Býður upp á hnapp sem sýnir næsta skref. Sjálfgefið: true
`auto_cross` valfrjálst í settings boolean	boolean	Þegar samsvörun er merkt eru hinir reitirnir í sömu röð og dálki strikaðir út. Sjálfgefið: true
`clue_mode` valfrjálst í settings string	string	Hver skrifar vísbendingarnar sem leikmenn sjá: búnar til út frá töflunni, þínar eigin setningar í free_clues, eða engar. Eitt af `generatedfreenone` Sjálfgefið: "generated"
`free_clues` valfrjálst í settings string[]	string[]	Þínar eigin vísbendingasetningar, sýndar eins og þær eru skrifaðar, með clue_mode "free". Ekkert athugar þær.

Reitur	Tegund	Hvað hann gerir
`clue_mode` valfrjálst í settings string	string	Reglur sýndar sem myndir eða sem setningar. Eitt af `visualtext` Sjálfgefið: "visual"
`unique_object_picks` valfrjálst í settings boolean	boolean	Hvert form má aðeins setja einu sinni. Sjálfgefið: false
`hide_color_picker` valfrjálst í settings boolean	boolean	Leikmenn geta ekki breytt lit formanna. Sjálfgefið: false

Búðu til verkefni úr þínu eigin kerfi

Fyrsta fyrirspurnin þín

Auðkenning

Meginmál fyrirspurnarinnar

Það sem kemur til baka

Að búa til eða uppfæra

Tíðnitakmörk

Villur

Endapunktar

Eitthvað sem virkar ekki rétt?