বিশ্রামের রেফারেন্স উপস্থাপনা - শব্দার্থ লিঙ্ক বনাম ইউরি


9

আমরা আমাদের গ্রাহকের অ্যাকাউন্টের তথ্য খুলতে একটি RESTful API ডিজাইন করছি। আমাদের উপস্থাপনা রয়েছে যা বর্তমান সংস্থান সম্পর্কিত অন্যান্য সংস্থাগুলির রেফারেন্স ধারণ করে। এটি বেশ কয়েকটি সেরা অনুশীলন থেকে আমরা পাবলিক এপিআই পাশাপাশি প্রকাশিত উপকরণগুলিতে খুঁজে পেতে সক্ষম হয়েছি। উপস্থাপনাগুলি এক্সএমএল বা জেএসএন হতে পারে।

উদাহরণস্বরূপ কোনও অ্যাকাউন্ট সংস্থান হিসাবে আমাদের অ্যাকাউন্টের ঠিকানা এবং একটি পৃষ্ঠা তালিকাভুক্ত সূত্রের উল্লেখ থাকতে পারে, আমাদের প্রথম, পরের এবং পূর্ববর্তী পৃষ্ঠাগুলির রেফারেন্স থাকবে।

<link title="" rel="" href="" />একটি ও'রিলি বইতে বর্ণিত হিসাবে নেটফ্লিক্স এবং গুগলের এপিআইতে ব্যবহৃত হিসাবে প্রথমে এপিআই নকশা করা হয়েছিল । যখন আমাদের কিউএ ইঞ্জিনিয়ারদের অটোমেশন স্যুটটি লেখার সময় এসেছিল, তখন তারা লিঙ্কগুলি ডিসায়রিয়াস করতে সমস্যা হয়েছিল। আমরা এখন সহজ ইউরি স্ট্রিং উপাদানগুলির পরামর্শ দিয়েছি যা ফেসবুক এবং টুইটার দ্বারা এপিআইতে ব্যবহৃত হয়েছে।

আমাদের কিউএ ইঞ্জিনিয়াররা তখন থেকেই তাদের ডিসিরিয়ালাইজেশন সম্পর্কিত সমস্যাগুলি সমাধান করেছে, তবে আমার কাছে এখনও সিএনেন্টিক লিঙ্কগুলির সাথে বর্তমান এপিআই স্পেসটি ব্যবহার করা সহজ করার বিষয়ে উদ্বেগ রয়েছে। আমাদের এপিআই প্রাথমিকভাবে আমাদের গ্রাহকরা এবং কিছু তৃতীয় পক্ষের অংশীদারিত্বের দ্বারা গ্রাস করবে এবং আমরা রেস্টে গিয়েছি কারণ পূর্ববর্তী এক্সএমএল-আরপিসি এপিআই আমাদের গ্রাহকদের পক্ষে খুব কঠিন ছিল।

TL; ড;

প্রশ্ন:

এমন কি যিনি সিমিক্যাল লিঙ্ক উপস্থাপনাকে কার্যকর করেছেন গ্রাহক সমস্যার সাথে সমস্যা?


আপডেট (//১১): আমি অর্থপূর্ণ লিঙ্কগুলির সাথে থাকার সিদ্ধান্ত নিয়েছি এবং আশা করি যে বিভ্রান্তি একটি প্রান্তের ঘটনা। কিছু গ্রাহকের সাথে এপিআই লাইভ হয়ে গেলে আমি আমাদের অভিজ্ঞতার সাথে প্রশ্নের উত্তরটি মনে রাখার চেষ্টা করব।


সম্পাদনা করুন: উদাহরণ যুক্ত করুন

সিমেন্টিক অ্যাকাউন্ট জেএসএন:

{
    "username": "paul",
    "links": [
        {
            "title": "addresses",
            "rel": "related",
            "href": "http://example.com/account/paul/addresses"
        },
        {
            "title": "history",
            "rel": "related",
            "href": "http://example.com/account/paul/history"
        }
    ]
}

সিমেন্টিক অ্যাকাউন্ট এক্সএমএল:

<account>
    <username>paul</username>
    <link title="addresses" rel="related" href="http://example.com/account/paul/addresses" />
    <link title="history" rel="related" href="http://example.com/account/paul/history" />
</account>

সাধারণ অ্যাকাউন্ট JSON:

{
    "username": "paul",
    "addresses": "http://example.com/account/paul/addresses"
    "history": "http://example.com/account/paul/history"
}

সাধারণ অ্যাকাউন্ট এক্সএমএল:

<account>
    <username>paul</username>
    <addresses>http://example.com/account/paul/addresses</addresses>
    <history>http://example.com/account/paul/history</history>
</account>

আপনি কি আমাদের মূল শব্দার্থক লিঙ্কগুলির দৃ concrete় উদাহরণ এবং "সরল ইউরি স্ট্রিং উপাদানগুলি" দিতে পারেন? আপনি এই শব্দগুলি বিশেষত পরবর্তীকালের দ্বারা কী বোঝাতে চাইছেন তা ভয়াবহভাবে পরিষ্কার নয়।
টম অ্যান্ডারসন

কংক্রিট উদাহরণ সহ আপডেট করা। আমি পৃষ্ঠাযুক্ত তালিকা / সংগ্রহগুলির উদাহরণগুলিও যুক্ত করতে পারি যদি এটি সাহায্য করে।
পল

উত্তর:


3

আমি বরং চাই:

{
  "username": "paul",
  "address": {
      "rel": "related",
      "href": "http://example.com/account/paul/addresses"
  },
  "history" {
      "rel": "related",
      "href": "http://example.com/account/paul/history"
  }
}

এটি অ্যারেটিকে সরিয়ে দেয় এবং অবজেক্টটিকে ট্র্যাভারেজেবল করে তোলে (কোনও অ্যাকাউন্টের ঠিকানা পেতে যেমন জাভাস্ক্রিপ্টে কেউ সমস্ত লিঙ্কের মধ্যে লুপিংয়ের পরিবর্তে এবং অ্যাকাউন্টের ঠিকানার মতো দেখতে এমন একাউন্ট অনুসন্ধানের পরিবর্তে অ্যাকাউন্ট.এড্রেস.ইরেফ বলতে পারে)। সংশ্লিষ্ট এক্সএমএল:

<account>
    <username>paul</username>
    <addresses>
        <link rel="related" href="http://example.com/account/paul/addresses" />
    </addresses>
    <history>
        <link rel="related" href="http://example.com/account/paul/history" />
    </history>
</account>

আপনি কি মনে করেন?


1

শব্দার্থক ওয়েবের স্বপ্ন হ'ল লিঙ্কগুলি স্বয়ংক্রিয়ভাবে আবিষ্কার করা যায়। যেহেতু শক্ত অংশটি লিংকগুলি বোঝে এবং সেগুলি কীভাবে ব্যবহার করতে হয়, তাই আমি বিশ্বাস করি যে শব্দার্থক তথ্যটি তেমন কার্যকর নয়।

আমার কাছে সিমান্টিক এক্সএমএল ফর্মগুলির দিকে সামান্য ঝোঁক রয়েছে কারণ "রিল" বৈশিষ্ট্যের স্পেস-বিভাজিত ক্ষেত্রগুলির একটি সংজ্ঞায়িত এক্সটেনসিবিলিটি ব্যবস্থা রয়েছে এবং "লিঙ্ক" ভালভাবে বোঝা গেছে।

এই জাতীয় এপিআইয়ের ভোক্তা হিসাবে আমি অন্য কোনও তফাত দেখতে পাচ্ছি না।

আমাদের সাইট ব্যবহার করে, আপনি স্বীকার করেছেন যে আপনি আমাদের কুকি নীতি এবং গোপনীয়তা নীতিটি পড়েছেন এবং বুঝতে পেরেছেন ।
Licensed under cc by-sa 3.0 with attribution required.