ল্যাব কালেক্টর - লোগোসংস্করণ 2.0 - নভেম্বর 2021
Web সার্ভিস অ্যাপ্লিকেশন প্রোগ্রামিং ইন্টারফেস সফটওয়্যার
ব্যবহারকারীর নির্দেশিকা

Web সার্ভিস অ্যাপ্লিকেশন প্রোগ্রামিং ইন্টারফেস সফটওয়্যার

ল্যাব কালেক্টর Web সার্ভিস অ্যাপ্লিকেশন প্রোগ্রামিং ইন্টারফেস সফটওয়্যার

ভূমিকা

ল্যাব কালেক্টর Web সার্ভিস অ্যাপ্লিকেশন প্রোগ্রামিং ইন্টারফেস (API) তৃতীয় পক্ষের অ্যাপ্লিকেশনগুলিকে ল্যাবকলেক্টরের ডাটাবেস (মডিউল) এবং অ্যাড-অনগুলির (ELN এবং LSM) সাথে যোগাযোগ করতে দেয়।
এপিআই একটি রিপ্রেজেন্টেশনাল স্টেট ট্রান্সফার (REST) ​​আর্কিটেকচারের উপর ভিত্তি করে তৈরি করা হয়েছে যা ইউনিফর্ম রিসোর্স আইডেন্টিফায়ার (URI) এর মাধ্যমে রিসোর্সে অ্যাক্সেস করতে দেয় এবং সেগুলির উপর কাজ করে।
দ্রষ্টব্য: জুন 2017 থেকে API v1 বন্ধ করা হয়েছে এবং সমস্ত নতুন বিবর্তন API v2 তে রয়েছে।

LABCOLLECTOR API

2-1। API সেটআপ
প্রথমত, আপনাকে আপনার ল্যাবকলেক্টর সফ্টওয়্যারে আপনার আবেদনটি ঘোষণা করতে হবে। অ্যাপ্লিকেশন ঘোষণা সেটআপ ফর্ম অ্যাক্সেস করতে, সুপার-প্রশাসক অধিকার সহ LabCollector এ লগ ইন করুন এবং অ্যাডমিন > সেটআপ পৃষ্ঠাতে যান৷ তারপর সিলেক্ট করুন Web পরিষেবা API লিঙ্ক। ল্যাব কালেক্টর Web সার্ভিস অ্যাপ্লিকেশন প্রোগ্রামিং ইন্টারফেস সফটওয়্যার - API সেটআপআপনি এখন আছে Web পরিষেবা API অ্যাপ্লিকেশন পরিচালনা পৃষ্ঠা। একটি নতুন আবেদন ঘোষণা করতে, কেবল এই ফর্মটি পূরণ করুন: ল্যাব কালেক্টর Web সার্ভিস অ্যাপ্লিকেশন প্রোগ্রামিং ইন্টারফেস সফটওয়্যার - API সেটআপ 1

  • নাম: আপনার আবেদনের নাম।
  • এই অ্যাপ্লিকেশনের সাথে সংযুক্ত মডিউল: মডিউল নির্বাচন করুন যেখানে অ্যাপ্লিকেশন অ্যাক্সেস করতে পারে।
  • ডিফল্ট অপারেটর: আপনি যদি প্রতিটি অনুরোধে এই তথ্য ঢোকাতে না চান তাহলে পরিচিতিটি নির্বাচন করুন যা ডিফল্ট অপারেটর হবে।
  • আইপি সীমাবদ্ধতা: নিরাপত্তা বিকল্প আপনাকে IP ঠিকানাগুলির একটি তালিকা ঘোষণা করতে দেয়, যা আপনাকে API-তে অনুরোধগুলি সম্পাদন করার অনুমতি দেবে।

অ্যাপ্লিকেশানের তালিকাটি আপনার LabCollector-এর জন্য সমস্ত অ্যাপ্লিকেশন দেখায় এবং আপনি যে কোনো সময়ে তাদের সুযোগ পরিবর্তন করতে পারেন।
আপনার কাছে টোকেনের অ্যাক্সেসও রয়েছে যা API-তে অনুরোধ করার সময় আপনার অ্যাপ্লিকেশন সনাক্ত করার জন্য প্রয়োজনীয়। ল্যাব কালেক্টর Web সার্ভিস অ্যাপ্লিকেশন প্রোগ্রামিং ইন্টারফেস সফটওয়্যার - API সেটআপ 2

দ্রষ্টব্য: এই বৈশিষ্ট্যটি ব্যবহার করতে, আপনাকে C সক্রিয় করতে হবেurl আপনার পিএইচপি পছন্দের উপর। লিনাক্সে, পিএইচপি-সি ইনস্টল করুনurl প্যাকেজ
উইন্ডোজে এবং আমাদের স্বয়ংক্রিয় ইনস্টলার দিয়ে, PHP.ini সম্পাদনা করুন এবং C-এর জন্য আনকমেন্ট এক্সটেনশনগুলিurl (এক্সটেনশন=php_curl.dll)।
2-2। অনুরোধ
তৃতীয় পক্ষের অ্যাপ্লিকেশন এবং LabCollector এর মধ্যে ডায়ালগ web service API HTTP 1.1 প্রোটোকলের উপর ভিত্তি করে।
2-2-1। API পদ্ধতি
আপনি HTTP বা HTTPS অনুরোধ পাঠাতে পারেন web একটি সম্পদের উপর কাজ করার জন্য একটি পদ্ধতি সহ পরিষেবা।

  • একটি সম্পদ পড়ার জন্য GET পদ্ধতি
  • একটি নতুন সংস্থান তৈরি করতে POST পদ্ধতি
  • একটি সম্পদ পরিবর্তন করার জন্য PUT পদ্ধতি
  • একটি সম্পদ মুছে ফেলার পদ্ধতি DELETE

2-2-2। হেডার
API-তে একটি অনুরোধের জন্য কিছু নির্দিষ্ট HTTP/HTTPS শিরোনাম প্রয়োজন:

  • স্বীকার শিরোনামটি আপনার অনুরোধ, টেক্সট/এক্সএমএল বা অ্যাপ্লিকেশন/জেএসএন-এর পছন্দসই প্রতিক্রিয়া বিন্যাসকে সংজ্ঞায়িত করে।
  • X-LC-APP-Auth শিরোনাম হল যেখানে আপনি আপনার অ্যাপ্লিকেশন টোকেন রাখেন যা API-তে আপনার অনুরোধ অনুমোদন করার জন্য প্রয়োজনীয়।
  • X-LC-APP-Charset হেডার আপনার অ্যাপ্লিকেশনের অক্ষর এনকোডিং সংজ্ঞায়িত করে। এটি API-কে উপযুক্ত এনকোডিং সহ প্রতিক্রিয়া ফেরত পাঠাতে এবং আপনার POST এবং PUT অনুরোধগুলিকে LabCollector-এর অক্ষর এনকোডিং (ISO 8859-1) এ সঠিকভাবে রূপান্তর করতে দেয়।

2-2-3। টুল
আপনি পোস্টম্যান (https://www.getpostman.com/).

ইউনিফর্ম রিসোর্স আইডেন্টিফায়ার (URI)

2-3-1। মেথো পানd
সাধারণ
প্রতিটি LabCollector মডিউল ডেটা একটি অনন্য URI দ্বারা চিহ্নিত করা হয় (মডিউলের URI-এর সম্পূর্ণ তালিকার জন্য অ্যানেক্স দেখুন):
[PATH_TO_LABCOLLECTOR]/webservice/v2/[MODULE] এই অনুরোধটি একটি মডিউলের সমস্ত ডেটার তালিকার উত্তর দেয়।
আপনি আপনার URI-তে প্যারামিটার যোগ করে মডিউল ডেটা অনুসন্ধান করতে পারেন। আপনি একটি ক্ষেত্রের মানের সাথে মেলে এমন একটি কীওয়ার্ড সহ একটি প্যারামিটার পাস করতে পারেন, যেমন:[PATH_TO_LABCOLLECTOR]/webservice/v2/[MODULE]?name=[KEYWORD]যেমন
[PATH_TO_LABCOLLECTOR]/webservice/v2/[MODULE]?name=First%20Record
এই অনুরোধ সেই রেকর্ডগুলি ফেরত দেয় যেখানে তাদের নামের মানটিতে "প্রথম রেকর্ড" কীওয়ার্ড রয়েছে।
এগুলি কিছু কাস্টম প্যারামিটার যা API অনুসন্ধান এবং ফিল্টারিং ক্রিয়া সম্পাদন করতে ব্যবহার করে।
কাস্টম প্যারামিটার

  • রেকর্ড_আইডি প্যারামিটার তার আইডি দ্বারা ডেটা নির্দিষ্ট করতে:
[PATH_TO_LABCOLLECTOR]/webservice/v2/[MODULE]?record_id=[RECORD_ID] যেমন [PATH_TO_LABCOLLECTOR]/webservice/v2/[MODULE]?record_id=1,19
এই অনুরোধটি আইডি 1 এবং আইডি 19 সহ রেকর্ড ফেরত দেয়। আপনি কমা দিয়ে আলাদা করে একাধিক আইডি নির্দিষ্ট করতে পারেন।
  • by_keywords প্যারামিটার একটি কীওয়ার্ড অনুসন্ধান করে:
[PATH_TO_LABCOLLECTOR]/webservice/v2/[MODULE]?by_keywords=[KEYWORD] যেমন [PATH_TO_LABCOLLECTOR]/webservice/v2/[MODULE]?by_keywords=cell
এই অনুরোধটি সমস্ত রেকর্ডের সমস্ত ক্ষেত্রে একটি অনুসন্ধান করে এবং মিলিত কক্ষগুলি প্রদান করে৷ আপনি একাধিক কীওয়ার্ডকে কমা দিয়ে আলাদা করে নির্দিষ্ট করতে পারেন।
  • by_keywords প্যারামিটার একটি কীওয়ার্ড অনুসন্ধান করে:
[PATH_TO_LABCOLLECTOR]/webservice/v2/[MODULE]?by_keywords=[KEYWORD] যেমন [PATH_TO_LABCOLLECTOR]/webservice/v2/[MODULE]?by_keywords=cell
এই অনুরোধটি সমস্ত রেকর্ডের সমস্ত ক্ষেত্রগুলিতে অনুসন্ধান করে এবং একটি মিলিত কক্ষ প্রদান করে৷ আপনি একাধিক কীওয়ার্ডকে কমা দিয়ে আলাদা করে নির্দিষ্ট করতে পারেন।
  • ক্ষেত্র পরামিতি, যদি আপনি API প্রতিক্রিয়াতে শুধুমাত্র কিছু ক্ষেত্রের মান পুনরুদ্ধার করতে চান:
[PATH_TO_LABCOLLECTOR]/webservice/v2/[MODULE]?fields=[FIELD1], [FIELD2] যেমন [PATH_TO_LABCOLLECTOR]/webservice/v2/[MODULE]?fields=count,name
এই অনুরোধটি মডিউল থেকে সমস্ত রেকর্ড ফেরত দেয় তবে শুধুমাত্র গণনা এবং নাম ক্ষেত্র সহ। আপনি কমা দিয়ে আলাদা করে একাধিক ক্ষেত্র নির্দিষ্ট করতে পারেন।
অনুরোধটি এখন "নির্বাচন" টাইপের কাস্টম ক্ষেত্রগুলির জন্য কমা দ্বারা পৃথক করা একাধিক মান গ্রহণ করেল্যাব কালেক্টর Web সার্ভিস অ্যাপ্লিকেশন প্রোগ্রামিং ইন্টারফেস সফটওয়্যার - ডিভাইস
  • search_on প্যারামিটার আপনাকে ডেটা অনুসন্ধান করতে দেয়। এবং আপনি নিম্নলিখিত হিসাবে তারিখ সীমা দ্বারা অনুসন্ধান করতে এটি ব্যবহার করতে পারেন:
[PATH_TO_LABCOLLECTOR]/webservice/v2/[মডিউল]&
search_on=date_field&from=XXXXXX&to=ZZZZZZ
আপনি যদি শুধুমাত্র FROM ব্যবহার করেন, ফলাফলটি FROM তারিখের চেয়ে বড় সব তারিখ দেবে। আপনি যদি শুধুমাত্র ব্যবহার করেন তবে এটি এই তারিখ পর্যন্ত সমস্ত মান ফিরিয়ে দেবে। ল্যাব কালেক্টর Web সার্ভিস অ্যাপ্লিকেশন প্রোগ্রামিং ইন্টারফেস সফটওয়্যার - ডিভাইস 1
  • sort_by প্যারামিটার আপনাকে আপনার অনুসন্ধান বাছাই করতে দেয়:

[PATH_TO_LABCOLLECTOR]/webservice/v2/[MODULE]?sort_by=[FIELD1]_DESC
যেমন [PATH_TO_LABCOLLECTOR]/webservice/v2/[MODULE]?sort_by=name_DESC
এই অনুরোধটি নাম ক্ষেত্রের নিচের ক্রম অনুসারে সাজানো সমস্ত রেকর্ড ফেরত দেয়। আপনি প্রতিটি ক্ষেত্রের জন্য একটি কমা এবং নির্দিষ্ট অর্ডার অ্যাসেন্ড্যান্ট _ASC" বা ডিসেন্ড্যান্ট "_DESC" দিয়ে আলাদা করে একাধিক সাজানোর_নির্দিষ্ট করতে পারেন।

  • limit_to প্যারামিটার আপনাকে ফলাফলের সংখ্যা সীমিত করতে দেয়:

[PATH_TO_LABCOLLECTOR]/webservice/v2/[MODULE]?limit_to=0,10
এই অনুরোধটি সূচক 10 থেকে শুরু করে 0টি রেকর্ড ফেরত দেয়। আপনি যদি সূচকটি নির্দিষ্ট না করেন তবে শুধুমাত্র নির্দেশিত ফলাফলের সংখ্যা ফেরত দেওয়া হয়।
এপিআই শিরোনামের প্রতিক্রিয়াতে দুটি কাস্টম ক্ষেত্রও প্রদান করে, "X-LC-QUERY-RESULT" যার মধ্যে বডি রেসপন্সে প্রত্যাবর্তিত ফলাফলের সংখ্যা এবং "X-LC-QUERY- TOTAL" আপনার সার্চের সাথে মিলে যাওয়া মোট রেকর্ড রয়েছে৷
প্রতিটি রেকর্ডের একটি অনন্য ইউআরআই রয়েছে:
[PATH_TO_LABCOLLECTOR]/webservice/v2/[MODULE]/[DATA_ID] এই অনুরোধটি একটি অনন্য রেকর্ডের উত্তর দেয়৷ আপনি যে রেকর্ডটি পুনরুদ্ধার করতে চান তার অনন্য আইডির সাথে [DATA_ID] অবশ্যই মেলে।
স্টোরেজ
স্টোরেজের সাথে লিঙ্ক করা প্রতিটি আইটেমের জন্য আপনার কাছে টিউব সার্টার ফিল্টারিং ফাংশন রয়েছে:
[PATH_TO_LABCOLLECTOR]/webservice/index.php?v=2&action=tube_sorter&box_i d=[BOX_ID] যেমন [PATH_TO_LABCOLLECTOR]/webservice/index.php?v=2&action=tube_sorter&box_i d=34
এই অনুরোধটি টিউব সার্টারের মতো বক্স আইডি 34-এ স্টোরেজ তথ্য প্রদান করে। আপনি কমা দিয়ে আলাদা করে একাধিক আইডি নির্দিষ্ট করতে পারেন। ল্যাব কালেক্টর Web সার্ভিস অ্যাপ্লিকেশন প্রোগ্রামিং ইন্টারফেস সফটওয়্যার - ডিভাইস 2

[PATH_TO_LABCOLLECTOR]/webservice/index.PHP?v=2&action=tube_sorter&box_i d=[BOX_ID]&record_name=[RECORD_NAME] যেমন [PATH_TO_LABCOLLECTOR]/webservice/index.PHP?v=2&action=tube_sorter&box_i d=206&record_name=ST-260
[PATH_TO_LABCOLLECTOR]/webservice/index.PHP?v=2&action=tube_sorter&recor d_name=[RECORD_NAME] যেমন [PATH_TO_LABCOLLECTOR]/webservice/index.PHP?v=2&action=tube_sorter&recor d_name=ST-260
এই অনুরোধগুলি ST-260 নামে একটি রেকর্ডে ফিল্টারিং সঞ্চালন করে৷ আপনি কমা দিয়ে আলাদা করে একাধিক রেকর্ডের নাম নির্দিষ্ট করতে পারেন। আপনি এখানে 206 বক্স আইডিও উল্লেখ করতে পারেন।[PATH_TO_LABCOLLECTOR]/webservice/index.PHP?v=2&action=tube_sorter&box_n ame=[BOX_NAME] যেমন [PATH_TO_LABCOLLECTOR]/webservice/index.PHP?v=2&action=tube_sorter&box_n ame=test-rack_06
এই অনুরোধ বক্স test-rack_06 এ ফিল্টারিং সঞ্চালন করে। আপনি কমা দিয়ে আলাদা করে একাধিক বাক্সের নাম নির্দিষ্ট করতে পারেন।
অ্যাকশন=টিউব_সর্টারের অন্যান্য সার্চ প্যারামিটার হতে পারে:
  • অবস্থান_আইডি
  • অবস্থানের নাম
  • facility_id
  • অনুষদের নাম
    এটি খালি বাক্সগুলিও ফিরিয়ে দেবে।
  • স্টোরেজ_সেক প্যারামিটার সেকেন্ডারি স্টোরেজ সম্পর্কে তথ্য পুনরুদ্ধার করার অনুমতি দেয়।
[PATH_TO_LABCOLLECTOR]/webservice/v2/[MODULE]&data_id=[DATA_ID]& fields=storage_sec ল্যাব কালেক্টর Web সার্ভিস অ্যাপ্লিকেশন প্রোগ্রামিং ইন্টারফেস সফটওয়্যার - ডিভাইস 3

পণ্য অনেক

  • অ্যাকশন গেট লট লট এবং রিএজেন্ট তথ্য পুনরুদ্ধার করতে দেয়
[PATH_TO_LABCOLLECTOR]/webservice/index.PHP?v=2&action=getLot
[PATH_TO_LABCOLLECTOR]/webservice/index.PHP?v=2&action=getLot&lo t_id=1/LT
[PATH_TO_LABCOLLECTOR]/webservice/index.PHP?v=2&action=getLot&ch em_id=2
ঐচ্ছিক পরামিতি হল lot_id (1 বা 1/LT বিন্যাসে) এবং chem_id। যদি এটি পরামিতি না পায়, তাহলে এটি সমস্ত সক্রিয় লট পুনরুদ্ধার করে।
রেসিপি
[PATH_TO_LABCOLLECTOR]/webservice/index.PHP?v=2&action=getRecipe s
[PATH_TO_LABCOLLECTOR]/webservice/index.PHP?v=2&action=getRecipe &recipe_id=[record_id] যেমন [PATH_TO_LABCOLLECTOR]/webservice/index.PHP?v=2&action=getRecipe &recipe_id=509
[PATH_TO_LABCOLLECTOR]/webservice/index.PHP?v=2&action=getরেসিপি লগ
[PATH_TO_LABCOLLECTOR]/webservice/index.PHP?v=2&action=getRecipe Report&log_id=[record_id] যেমন [PATH_TO_LABCOLLECTOR]/webservice/index.PHP?v=2&action=getRecipe Report&log_id=1218
আইডি প্রাক্তনamples কিন্তু এই কলগুলিতে বাধ্যতামূলক।
রেসিপি পেতে নিম্নলিখিত তথ্য প্রিন্ট করে: আইডি, নাম, বিবরণ, বিভাগ ল্যাব কালেক্টর Web সার্ভিস অ্যাপ্লিকেশন প্রোগ্রামিং ইন্টারফেস সফটওয়্যার - ডিভাইস 4

রেসিপি পান সেই recipe_id-এর জন্য নিম্নলিখিত তথ্য প্রিন্ট করে: id, নাম, বিবরণ, বিভাগ এবং তারপর উপাদানগুলি ল্যাব কালেক্টর Web সার্ভিস অ্যাপ্লিকেশন প্রোগ্রামিং ইন্টারফেস সফটওয়্যার - ডিভাইস 5getRecipeLogs নিম্নলিখিত তথ্য প্রিন্ট করে: আইডি, নাম, বিবরণ, বিভাগ ল্যাব কালেক্টর Web সার্ভিস অ্যাপ্লিকেশন প্রোগ্রামিং ইন্টারফেস সফটওয়্যার - ডিভাইস 6getRecipeReport বেস64 ফরম্যাটের অধীনে সেই log_id-এর জন্য রিপোর্ট পিডিএফ প্রিন্ট করে যা PDF এ ডিকোড করা যায়। ল্যাব কালেক্টর Web সার্ভিস অ্যাপ্লিকেশন প্রোগ্রামিং ইন্টারফেস সফটওয়্যার - ডিভাইস 7

2-3-2। পোস্ট পদ্ধতি
একটি নতুন সংস্থান তৈরি করতে, শুধুমাত্র পছন্দসই মডিউল URI-তে POST পদ্ধতির সাথে একটি অনুরোধ পাঠান:
[PATH_TO_LABCOLLECTOR]/webservice/v2/[MODULE] আপনার প্যারামিটার কীগুলি ক্ষেত্রের নামের সাথে মিলতে হবে।
নতুন রেকর্ড (POST) বা আপডেট (PUT) তৈরি করার সময় যোগ করা অনন্যতা ক্ষেত্রগুলি পরীক্ষা করুন
যদি একটি ক্ষেত্রের অনন্যতার জন্য একই মান সহ একটি ভিন্ন রেকর্ড বিদ্যমান থাকে, তাহলে API ক্রিয়াটি সম্পূর্ণ করবে না এবং কোড 409 (দ্বন্দ্ব) প্রদান করবে এবং পাঠ্য: 'XXX' ক্ষেত্রের মানটি অবশ্যই অনন্য হতে হবে। 'YYY' মান 'ZZZ' টেবিলে ইতিমধ্যেই বিদ্যমান। (স্ক্রিনশট দেখুন) ল্যাব কালেক্টর Web সার্ভিস অ্যাপ্লিকেশন প্রোগ্রামিং ইন্টারফেস সফটওয়্যার - ডিভাইস 8

দ্রষ্টব্য: প্রজেক্ট_কোড ক্ষেত্রটি POST এবং PUT-এ ব্যবহার করা যেতে পারে এবং এটি পাঠ্য আশা করে (আইডি নয়)। আপনি এখন একটি নতুন প্রকল্প কোড তৈরি করতে পারেন যদি এটি বিদ্যমান না থাকে এবং যদি অপারেটরের যথেষ্ট অনুমতি থাকে (প্রশাসক বা সুপার-প্রশাসক)।

  • অ্যাকশন অ্যাডবক্স আপনাকে একটি বাক্স তৈরি করতে দেয়
[PATH_TO_LABCOLLECTOR]/webservice/index.PHP?v=2&action= addBox
  • প্রয়োজনীয় পরামিতি:
    o নাম
    o টাইপ (একটি বৈধ প্রকার হতে হবে: বক্স, বক্স_নোগ্রিড, প্লেট, মাইক্রোপ্লেট, ভিজিট বি, ব্যাগ, শেলফ অংশ)
    o সরঞ্জাম (আইডি বা নাম সমর্থন করে এবং ল্যাবকলেক্টর স্টোরেজে থাকা আবশ্যক)।
    o আকার (বাক্সের প্রকারের উপর নির্ভর করে: একটি পরিদর্শনের জন্য সাংখ্যিক হওয়া উচিত, এবং একটি বাক্স, একটি প্লেট এবং একটি মাইক্রোপ্লেটের জন্য বিন্যাস (A:1.H:8))
  • ঐচ্ছিক পরামিতি:
    o বর্ণনা
    o তাক
    o রক্ষক

০১-০৩-২০১৫। PUT পদ্ধতি
একটি সংস্থান পরিবর্তন করতে, শুধুমাত্র PUT পদ্ধতির সাথে পছন্দসই রেকর্ড URI-তে একটি অনুরোধ পাঠান:
[PATH_TO_LABCOLLECTOR]/webservice/v2/[MODULE]/[DATA_ID] আপনার প্যারামিটার কীগুলি আপনি যে ক্ষেত্রের নাম পরিবর্তন করতে চান তার সাথে মেলে।
নিম্নলিখিত ক্রিয়াগুলির জন্য, মনে রাখবেন যে PUT অনুরোধগুলির জন্য, প্যারামিটারগুলি অবশ্যই শরীরে থাকতে হবে (এতে নয় URL).
দ URL হল [PATH_TO_LABCOLLECTOR]/webservice/index.PHP?v=2
শিরোনামগুলি হল: X-LC-APP-Auth, Accept.

  • ভলিউম সরান
    - পরামিতি:
    o রিমুভ ভলিউম (আবশ্যিক)
    o বারকোড, অনন্য_কোড, বা অ্যালিকোট_বারকোড (তাদের মধ্যে একটি অবশ্যই উপস্থিত থাকতে হবে)
    o পরিমাণ (বাধ্যতামূলক)
    - উত্তর: ঠিক আছে
  • স্টোরেজ সরান
    - পরামিতি:
    o দূরবর্তী স্টোরেজ (অবশ্যই)
    o বারকোড, অনন্য_কোড, বা অ্যালিকোট_বারকোড (তাদের মধ্যে একটি অবশ্যই উপস্থিত থাকতে হবে)
    - উত্তর: ঠিক আছে
  • রেজিস্ট্রি বই যোগ করুন
    – URL:
    [PATH_TO_LABCOLLECTOR]/webservice/index.php?v=2&module=[m odule] - পরামিতি:
    রেজিস্ট্রি বই যোগ করুন (অবশ্যক)
    রেকর্ড_আইডি (আবশ্যিক)
    o তারিখ (বাধ্যতামূলক, বিন্যাস yy yy/mm/dd বা yyyy-mm-dd)
    o মন্তব্য (বাধ্যতামূলক)
    o অপারেটর (ঐচ্ছিক, এটি এপিআই না পাঠালে ডিফল্ট অপারেটর ব্যবহার করা হবে)
    o কর্ম (ঐচ্ছিক, অবশ্যই LC-তে সংজ্ঞায়িত একটি বৈধ 'স্টোরেজ অ্যাকশন টাইপ' হতে হবে
    >প্রশাসক >পছন্দ > প্রক্রিয়া এবং কর্মের ধরন)
    - উত্তর: ঠিক আছে
  • সেকেন্ডারি স্টোরেজ যোগ করুন
    - পরামিতি:
    o সেকেন্ডারি স্টোরেজ যোগ করুন (অবশ্যক)
    বারকোড (আবশ্যিক)
    o box_id (বাধ্যতামূলক)
    o box_details (শুধুমাত্র গ্রিড ডিভাইডার, টিউব ট্রে এবং মাইক্রোপ্লেট সহ বাক্সের জন্য বাধ্যতামূলক। বাক্সটি যদি গ্রিড, ব্যাগ, ভিজিট বি বা শেলফের অংশবিহীন হয় তবে এটির প্রয়োজন নেই)
    o অনন্য_কোড (ঐচ্ছিক)
    o ভলিউম (ঐচ্ছিক)
    o মন্তব্য (ঐচ্ছিক)
    o cap_color (ঐচ্ছিক)

দ্রষ্টব্য: বাধ্যতামূলক পরামিতি উপস্থিত না থাকলে একটি ত্রুটি বার্তা ফিরে আসে; যদি বারকোড বিদ্যমান না থাকে; যদি অনন্য_কোডটি উপস্থিত থাকে তবে এটি অনন্য নয়; এবং, যদি রঙটি উপস্থিত থাকে তবে এটি বিদ্যমান না থাকে।
যদি প্যারামিটার box_details প্রাপ্ত না হয় এবং বাক্সের প্রকারের অবস্থানের প্রয়োজন হয় (গ্রিড, টিউব ট্রে, বা মাইক্রোপ্লেট সহ বাক্স), একটি ত্রুটি বার্তা ফেরত আসে। ল্যাব কালেক্টর Web সার্ভিস অ্যাপ্লিকেশন প্রোগ্রামিং ইন্টারফেস সফটওয়্যার - ডিভাইস 9ল্যাব কালেক্টর Web সার্ভিস অ্যাপ্লিকেশন প্রোগ্রামিং ইন্টারফেস সফটওয়্যার - ডিভাইস10দ্রষ্টব্য: প্রজেক্ট_কোড ক্ষেত্রটি POST এবং PUT-এ ব্যবহার করা যেতে পারে এবং এটি পাঠ্য আশা করে (আইডি নয়)। আপনি এখন একটি নতুন প্রকল্প কোড তৈরি করতে পারেন যদি এটি বিদ্যমান না থাকে এবং যদি অপারেটরের যথেষ্ট অনুমতি থাকে (প্রশাসক বা সুপার-প্রশাসক)।
2-3-4। DELETE পদ্ধতি
একটি সংস্থান মুছে ফেলতে, কেবল পছন্দসই রেকর্ড URI-তে DELETE পদ্ধতির সাথে একটি অনুরোধ পাঠান:
[PATH_TO_LABCOLLECTOR]/webservice/v2/[MODULE]/[DATA_ID]

API ত্রুটি বার্তা

বার্তা  প্রতিক্রিয়া কোড বর্ণনা 
অ্যাক্সেস করতে অ্যাপ্লিকেশন প্রমাণীকরণ প্রয়োজন Web সেবা' 401 অননুমোদিত অনুরোধে হয় হেডার প্যারামিটার X- LC-APP-Auth নেই বা বৈধ মান নেই
'অবৈধ কর্ম xxx' ৪০০ খারাপ অনুরোধ প্যারামিটার অ্যাকশনের 'টিউব_সার্টার' এর থেকে আলাদা মান রয়েছে
বা 'নেটব্যাকআপ'
অনুপস্থিত অনুসন্ধান পরামিতি! ৪০০ খারাপ অনুরোধ অনুরোধে অ্যাকশন=টিউব_সার্টার প্যারামিটার রয়েছে
তবে এটি নিম্নলিখিত প্যারামিটারগুলির মধ্যে অন্তত একটি অনুপস্থিত: box_id, box_name, record_name, unique_code, barcode, aliquot_barcode
মডিউল “XXX” বিদ্যমান নেই!' ৪০০ খারাপ অনুরোধ প্যারামিটার 'মডিউল' এর মান একটি GB সংগ্রাহক মডিউল নয়
মডিউল “XXX” এই ডেটা ভাগ করে না!' 403 নিষিদ্ধ প্যারামিটার 'মডিউল' এর মান চেক করা হয় না
ল্যাব কালেক্টর > অ্যাডমিন > সেটআপ > Web সেবা
'অনুরোধের ফরম্যাট গৃহীত হয় না!' ৪১৫ অসমর্থিত মিডিয়া টাইপ Accept প্যারামিটার ব্যবহার করা হয়, কিন্তু মানটি গৃহীত মানগুলির মধ্যে একটি নয়: application/XML বা application/JSON
(খালি) 406 গ্রহণযোগ্য নয় পদ্ধতিটি অবশ্যই নিম্নলিখিতগুলির মধ্যে একটি হতে হবে: GET, POST, PUT, DELETE
'কোন তথ্য পাওয়া যায়নি।' ৪০৪ খুঁজে পাওয়া যায়নি এই অনুরোধের পরামিতিগুলির সাথে কোনও ডেটা পাওয়া যায়নি৷
'ঠিক আছে।' 200 ঠিক আছে রেকর্ড সফলভাবে আপডেট করা হয়েছে৷
'দ্বন্দ্ব।' 409 দ্বন্দ্ব রেকর্ড হালনাগাদ করা যায়নি কারণ একটি আছে
তথ্যের মধ্যে দ্বন্দ্ব
এই মডিউলের জন্য কোন জীবের মান নেই ৪০৪ খুঁজে পাওয়া যায়নি শুধুমাত্র মডিউল "স্ট্রেন", "sampলেস" এবং মাইক্রোয়ারে"
একটি জীব মান আছে - আপনি একটি ভুল নির্বাচন করেছেন
মডিউল
এই মডিউলের জন্য কোনো বিভাগ মান নেই ৪০৪ খুঁজে পাওয়া যায়নি শুধুমাত্র মডিউল 'ডক্স'-এর বিভাগ আছে – আপনি বেছে নিয়েছেন
একটি ভুল মডিউল
Webপরিষেবার জন্য ব্যবহারকারীর প্রমাণীকরণ প্রয়োজন 401 অননুমোদিত অবচয়
আপনার আইপি এটি অ্যাক্সেস করার অনুমতি দেওয়া হয় না Web সেবা' 401 অননুমোদিত ক্লায়েন্ট আইপি এটির জন্য অনুমোদিত আইপিগুলির তালিকায় নেই
Webপরিষেবাগুলি (এলসি > অ্যাডমিন > সেটআপ > Web সেবা)
আপনার অনুরোধের সময় ত্রুটি, একটি নতুন তৈরি করতে নিম্নলিখিত তথ্য বাধ্যতামূলক৷
রেকর্ড: X, Y, Z'
৪০০ খারাপ অনুরোধ বাধ্যতামূলক ক্ষেত্রগুলি ছাড়াই নতুন ডেটা পোস্ট করার চেষ্টা করুন X, Y,
Z
আপনার অনুরোধের সময় একটি ত্রুটি ঘটেছে, ভলিউম সরাতে নিম্নলিখিত তথ্য বাধ্যতামূলক: অনন্য_কোড বা বারকোড বা অ্যালিকোট_বারকোড, পরিমাণ, পরিমাণ ৪০০ খারাপ অনুরোধ বাধ্যতামূলক ছাড়া ভলিউম অপসারণ করার প্রচেষ্টা
পরামিতি: অনন্য_কোড বা বারকোড বা অ্যালিকোট_বারকোড,
পরিমাণ
আপনার অনুরোধের সময় একটি ত্রুটি ঘটেছে, নিম্নলিখিত তথ্য বাধ্যতামূলক
সঞ্চয়স্থান সরান: অনন্য_কোড বা বারকোড বা
aliquot_barcode, পরিমাণ '
৪০০ খারাপ অনুরোধ একটি বাধ্যতামূলক ছাড়া সঞ্চয়স্থান অপসারণ করার প্রচেষ্টা
প্যারামিটার: অনন্য_কোড বা বারকোড বা অ্যালিকোট_বারকোড
" 200 ঠিক আছে অনুরোধ করা ডেটা সফলভাবে ফেরত দেওয়া হয়েছে

ল্যাবকলেক্টর WEB SERVICE API - ANNEX

API এর URI সিস্টেম একটি সহজ এবং পরিষ্কার ব্যবহার করে URL. নিম্নলিখিত সারণীতে উল্লেখ করা URI ব্যবহার করতে Apache থেকে পুনর্লিখন ইঞ্জিন সক্রিয় করতে ভুলবেন না। যদি LabCollector সার্ভারটি পুনর্লিখন ইঞ্জিন সমর্থন না করে তবে অনুগ্রহ করে সম্পূর্ণ ব্যবহার করুন URL আপনার অনুরোধের জন্য প্যাটার্ন (সেকেন্ডারি URL প্রতিটি লাইনের)।

UM মডিউল বর্ণনা
webservice/v2/strains webservice/index.PHP?v=2&module=strai ns পোস্ট পান স্ট্রেন এবং কোষ সমস্ত রেকর্ডের তালিকা
webservice/v2/strains/(DATA JD] webservice/index.PHP?v=2&module=strai ns&data jd।[DATA _ID] রাখো স্ট্রেন এবং কোষ অনন্য রেকর্ড
webservice/v2/strains/কাস্টম ক্ষেত্র webservice/index.php?v=2&module=strai ns&getModuleCustomFields=1 পান স্ট্রেন এবং কোষ কাস্টম ক্ষেত্রগুলির তালিকা
webservice/v2/strains/organisms webservice/index.PHP?v=2&module=strai ns&getModuleOrganisms=1 পান স্ট্রেন এবং কোষ জীব এর তালিকা
webservice/v2/plasmids webservice/index.php?v=2&module=plas mids পোস্ট পান প্লাজমিড সমস্ত রেকর্ডের তালিকা
webservice/v2/plasmids/IDATAjD] webservice/index.php?v=2&module=plasmids&data _id=IDATA _ID] পান PUT প্লাজমিড অনন্য রেকর্ড
webservice/v2/plasmids/কাস্টম ক্ষেত্র webservice/index.PHP?v=2&module=plas mids&getModuleCustomFields=1 পান প্লাজমিড ক্ষেত্র কাস্টম তালিকা
webservice/v2/primers webservice/index.PHP?v=2&module=pri mers পোস্ট পান প্রাইমার সমস্ত রেকর্ডের তালিকা
webservice/v2/primers/[ডেটা জেডি] webservice/index.PHP?v=2&module=pri mers&data _idADATA _ID] PUT GET প্রাইমার অনন্য রেকর্ড
webservice/v2/primers/কাস্টম ক্ষেত্র পান প্রাইমার কাস্টম ক্ষেত্রগুলির তালিকা
webservice/index.PHP?v=2&module=pri mers&getModuleCustomFields=1
webservice/v2/কেমিক্যালস webservice/index.PHP?v=2&module=che micals পোস্ট পান রিএজেন্ট এবং সরবরাহ সমস্ত রেকর্ডের তালিকা
webservice/v2/chemicals/IDATA _ID] webservice/index.PHP?v=2&module=che micals&data_idADATA _ID] রাখো রিএজেন্ট এবং সরবরাহ অনন্য রেকর্ড
webservice/v2/কেমিক্যালস/কাস্টম ক্ষেত্র webservice/index.PHP?v=2&module=che micals&getModuleCustomFields=1 পান রিএজেন্ট এবং সরবরাহ ক্ষেত্র কাস্টম তালিকা
webservice/v2/sampলেস webservice/index.PHP?v=2&module=sam pies পোস্ট পান Sampলেস সমস্ত রেকর্ডের তালিকা
webservice/v2/sampলেস/IDATA_ID) web service/index.PHP?v=2&module=sam ples&data_id=[DATA _ID] রাখো Sampলেস অনন্য রেকর্ড
webservice/v2/sampলেস/কাস্টম ক্ষেত্র webservice/index.PHP?v=2&module=sam ples&getModuleCustomFields=1 পান Sampলেস কাস্টম ক্ষেত্রগুলির তালিকা
webservice/v2/sampলেস/জীব webservice/index.php?v=2&module=sam ples&getModuleOrganisms=1 পান Sampলেস জীবের তালিকা
webservice/v2/sampলেস/প্রকার webservice/index.PHP?v=2&module=sam ples&getModuleTypes=1 পান Sampলেস এস এর তালিকাampলে প্রকার
webservice/v2/অ্যান্টিবডি webservice/index.PHP?v=2&module=anti bodies পোস্ট পান অ্যান্টিবডি সমস্ত রেকর্ডের তালিকা
webservice/v2/antibodies/(DATA _iDi webservice/index.PHP?v=2&module=anti bodies&data_id=IDATA _ID] রাখো অ্যান্টিবডি অনন্য রেকর্ড
webservice/v2/অ্যান্টিবডি/কাস্টম ক্ষেত্র webservice/index.PHP?v=2&module=anti bodies&getModuleCustomFields=1 পান অ্যান্টিবডি ক্ষেত্র কাস্টম তালিকা
webservice/v2/sequences webservice/index.PHP?v=2&module=seq uences পোস্ট পান সিকোয়েন্স সমস্ত রেকর্ডের তালিকা
webservice/v2/sequences/(ডেটা _iDI webservice/index.PHP?v=2&module=seq uences&data _icHCIATA JD] পান
PUT
সিকোয়েন্স অনন্য রেকর্ড
webservice/v2/sequences/কাস্টম ক্ষেত্র webservice/index.PHP?v=2&module=seq uences&getModuleCustomFields=1 পান সিকোয়েন্স ক্ষেত্র কাস্টম তালিকা
webservice/v2/animals webservice/index.PHP?v=2&module=ani mats পোস্ট পান প্রাণী সমস্ত রেকর্ডের তালিকা
webservice/v2/animals/(DATA JD] webservice/index.PHP?v=2&module=ani mals&data _ick[DATA JD] পান PUT প্রাণী অনন্য রেকর্ড
webservice/v2/animals/কাস্টম ক্ষেত্র webservice/index.PHP?v=2&module=ani malsketModuleCustomFields=1 পান প্রাণী কাস্টম ক্ষেত্রগুলির তালিকা
webservice/v2/equipments webservice/index.php?v=2&module=equi pments পোস্ট পান যন্ত্রপাতি সমস্ত রেকর্ডের তালিকা
webservice/v2/equipments/PATA _el Webservice/index.php?v=2&module=equi pments&data _idADATA _ID] রাখো যন্ত্রপাতি অনন্য রেকর্ড
webservice/v2/equipments/কাস্টম ক্ষেত্র webservice/index.PHP?v=2&module=equi pments&getModuleCustomFields=1 পান সরঞ্জাম ক্ষেত্র কাস্টম তালিকা
webservice/v2/structures webservice/index.PHP?v=2&module=stru নিরাময় পোস্ট পান রাসায়নিক কাঠামো সমস্ত রেকর্ডের তালিকা
webservice/v2/structures/(DATA_ID] webservice/index.PHP?v=2&module=stru ctures&data jd=(DATA JD] রাখো রাসায়নিক কাঠামো অনন্য রেকর্ড
webservice/v2/structures/কাস্টম ক্ষেত্র webservice/index.PHP?v=2&module=stru cturesketModuleCustomFields=1 পান রাসায়নিক কাঠামো কাস্টম ক্ষেত্রগুলির তালিকা
webservice/v2/docs webservice/index.PHP?v=2&module=docs পোস্ট পান নথিপত্র সমস্ত রেকর্ডের তালিকা
webservice/v2/docs/(DATA JD] webservice/index.PHP?v=2&module=docs &data _idADATA _ID] রাখো নথিপত্র অনন্য রেকর্ড
webservice/v2/docs/কাস্টম ক্ষেত্র webservice/index.php?v=2&module=docs &getModuleCustomFields=1 পান নথিপত্র কাস্টম ক্ষেত্রগুলির তালিকা
webservice/v2/docs/categories webservice/index.PHP?v=2&module=docs &getModuleCategories=1 পান নথি বিভাগ এর তালিকা
webservice/v2/book webservice/index.PHP?v=2&module=abo ঠিক আছে পোস্ট পান ঠিকানা বই সমস্ত রেকর্ডের তালিকা
webservice/v2/book/(ডেটা _ID] webservice/index.php?v=2&module=abo ঠিক আছে&data_idADATA _ID] রাখো ঠিকানা বই অনন্য রেকর্ড
webservice/v2/book/কাস্টম ক্ষেত্র webservice/index.PHP?v=2&module=abo ok&getModuleCustomFields=1 পান ঠিকানা বই কাস্টম ক্ষেত্রগুলির তালিকা
webservice/v2/book/categories webservice/index.PHP?v=2&module=abo ok&getModuleCategories=1 পান ঠিকানা বই বিভাগ এর তালিকা
webservice/v2/microarrays webservice/index.PHP?v=2&module=micr অ্যারে পোস্ট পান মাইক্রোঅ্যারে সমস্ত রেকর্ডের তালিকা
webservice/v2/microarrays/(DATA_ID] webservice/index.PHP?v=2&module=micr oarrays&data_id=[DATA _ID] পান PUT মাইক্রোঅ্যারে অনন্য রেকর্ড
webservice/v2/microarrays/কাস্টম ক্ষেত্র webservice/index.PHP?v=2&module=micr oarrays&getModuleCustomFields=1 পান মাইক্রোঅ্যারে কাস্টম ক্ষেত্রগুলির তালিকা
webservice/v2/microarrays/organisms webservice/index.PHP?v=2&module=micr oarrays&getModuleOrganisms=1 পান মাইক্রোয়ারের জীব এর তালিকা
webservice/v2/(CUSTOM_MODULE_NAM El
webservice/index.PHP?v=2&module=ECU STOM_MODULE_NAMEI
পোস্ট পান কাস্টম মডিউল সমস্ত রেকর্ডের তালিকা
webservice/v2/(CUSTOM_MODULE_NAM EMIDATA _ID] webservice/index.PHP?v=2&module=[CU STOM_MODULE_NAME] &data_id=[DATA _ID] রাখো কাস্টম মডিউল অনন্য রেকর্ড
webservice/v2/(CUSTOM_MODULE_NAM Elicustomfields webservice/index.PHP?v=2&module=[CU STOM_MODULE_NAME184getModuleCust omFields=1 পান কাস্টম মডিউল কাস্টম ক্ষেত্রগুলির তালিকা

ল্যাব কালেক্টর - লোগো 1

http://www.labcollector.comsales@agilebio.com
AgileBio USA
5473 Kearny ভিলা রোড স্যুট 255
সান দিয়েগো, CA 92123
USA
টেলিফোন: 347 368 1315
ফ্যাক্স: (800) 453 9128
http://www.agilebio.com
AgileBio সদর দপ্তর
৭৫ রুয়ে দে লরমেল
75015 প্যারিস
ফ্রান্স
টেলিফোন: 01 41 79 15 85
ফ্যাক্স: 01 72 70 40 22

দলিল/সম্পদ

ল্যাব কালেক্টর Web সার্ভিস অ্যাপ্লিকেশন প্রোগ্রামিং ইন্টারফেস সফটওয়্যার [পিডিএফ] ব্যবহারকারীর নির্দেশিকা
Web সার্ভিস অ্যাপ্লিকেশন প্রোগ্রামিং ইন্টারফেস, সফটওয়্যার, Web সার্ভিস অ্যাপ্লিকেশন প্রোগ্রামিং ইন্টারফেস সফটওয়্যার

তথ্যসূত্র

একটি মন্তব্য করুন

আপনার ইমেল ঠিকানা প্রকাশ করা হবে না. প্রয়োজনীয় ক্ষেত্রগুলি চিহ্নিত করা হয়েছে *