Articles

Այս էջում ներկայացված են GET հարցումների օրինակներ JSON:API մոդուլի համար։

Ստորև բերված բոլոր օրինակներում հարցման հեդերներ պարտադիր չեն։ Ավտենտիֆիկացում նույնպես պարտադիր չէ, եթե անանուն օգտվողները կարող են մուտք գործել բովանդակության էակներին։ Կոնֆիգուրացիոն էակների (օր.՝ մենյու) դեպքում տես վերջին բաժինները։

Ուշադրություն՝ բոլոր դեպքերում, երբ անհրաժեշտ է id, պետք է օգտագործել էակի uuid-ը, ոչ թե սերիական ID-ն։

Այս էջում ներկայացված են տարբեր POST հարցումների օրինակներ JSON:API մոդուլի համար։

POST հարցումները օգտագործվում են նոր ռեսուրսներ ստեղծելու համար։ Եթե ցանկանում եք փոփոխել ռեսուրսները, պետք է օգտագործեք PATCH հարցումներ։

Այս էջում ներկայացված են PATCH հարցումների օրինակներ JSON:API մոդուլի համար։

Թարմացման գործողության ակտիվացում

Անցեք /admin/config/services/jsonapi
և ընտրեք "Accept all JSON:API create, read, update, and delete operations." տարբերակը։

Այս էջը ներկայացնում է JSON:API մոդուլի DELETE հարցումների օրինակներ։

DELETE գործողության ակտիվացում

Անցեք /admin/config/services/jsonapi
և միացրեք "Accept all JSON:API create, read, update, and delete operations." տարբերակը։

Որոշ կայքեր կարող են չցանկանալ բացահայտել որոշակի JSON:API ռեսուրսների տիպեր կամ դաշտեր, կամ կարող են ցանկանալ վերանվանել դաշտերը՝ ավելի մաքուր ինտերֆեյս ապահովելու համար։

Ֆայլերի վերբեռնումը այժմ աջակցվում է, մանրամասների համար տեսեք թողարկման նշումները՝ https://www.drupal.org/node/3024331

Այս երկու նկարները ցույց են տալիս, թե ինչպես օգտագործել Postman-ը՝ ֆայլ վերբեռնելու համար JSON:API-ով

Կարճ՝ TL;DR

Ընտրեք REST, եթե ունեք ոչ էյնթիթի տվյալներ, որոնք ցանկանում եք հասանելի դարձնել։ Մնացած բոլոր դեպքերում ընտրեք JSON:API։

Ավելի մանրամասն՝

JSON:API-ն ամբողջությամբ հիմնված է էյնթիթիների վրա։ Սա նշանակում է, որ այն չի կարող մշակել բիզնես կանոններ կամ կատարել այնպիսի գործողություններ, որոնք հնարավոր չէ դիտարկել որպես "CRUD" (ստեղծում, ընթերցում, թարմացում, ջնջում): Բիզնես լոգիկան՝ ինչպես նոր հաշվի գրանցումը, օգտագործողի մուտքագրումը կամ գաղտնաբառի վերականգնումը, չեն ընդգրկված JSON:API-ում։ Այս գործողություններից շատերը արդեն հասանելի են Drupal core-ով։

Ստորև ներկայացված է ամենահաճախ օգտագործվող հնարավորությունների և դրանց լուծումների ոչ լրիվ ցանկը։

Ռեսուրսների և դաշտերի անվանափոխումն ու անջատումը այժմ արդեն ընդգրկված է հիմնականում (core)։

Եթե անհրաժեշտ է փոխել ռեսուրսի հատկությունները, օրինակ՝ API ուղին, ռեսուրսի քանակները կամ include-ների լռելյայն արժեքները, կամ եթե ցանկանում եք դաշտեր կամ ռեսուրսներ անջատելու ինտերֆեյս, օգտագործեք JSON:API Extras մոդուլը։

JSON:API մոդուլը նախատեսված է Drupal-ում Entity API, Field API և Typed Data API-ով սահմանված տվյալների մոդելը (բովանդակությունը) JSON:API սպեցիֆիկացիային համապատասխան API-ի միջոցով հասանելի դարձնելու համար՝ հնարավորություն տալով արտաքին համակարգերին փոխազդել Drupal-ի կառավարվող տվյալների (ենթակառույցների) հետ:

Այդ գործընթացում, այն հետևում է Drupal-ի բոլոր անվտանգության միջոցառումներին տվյալների համար՝