ประเภทเนื้อหา JSON ที่ถูกต้องคืออะไร?

ฉันเคยยุ่งกับJSON มาซักพักแล้วก็แค่ผลักมันออกมาเป็นข้อความและมันก็ไม่ได้ทำให้ใครบาดเจ็บ (ที่ฉันรู้) แต่ฉันก็อยากจะทำสิ่งต่าง ๆ ให้ถูกต้อง

ฉันได้เห็นดังนั้นหลายคนอ้างว่า "มาตรฐาน" สำหรับประเภทเนื้อหา JSON นี้:

application/json
application/x-javascript
text/javascript
text/x-javascript
text/x-json

แต่อันไหนที่ถูกต้องหรือดีที่สุด? ฉันรวบรวมว่ามีปัญหาด้านความปลอดภัยและการสนับสนุนเบราว์เซอร์แตกต่างกันไป

ฉันรู้ว่ามีคำถามคล้ายกันประเภท MIME คืออะไรหาก JSON ถูกส่งคืนโดย REST API แต่ฉันต้องการคำตอบที่ตรงเป้าหมายกว่าเล็กน้อย

สำหรับข้อความ JSON:

application/json

MIME ชนิดของสื่อสำหรับข้อความ JSON application/jsonคือ การเข้ารหัสเริ่มต้นคือ UTF-8 (ที่มา: RFC 4627 )

สำหรับJSONP (จาวาสคริปต์ที่รันได้ ) ที่มีการโทรกลับ:

application/javascript

นี่คือโพสต์บล็อกบางส่วนที่กล่าวถึงในความคิดเห็นที่เกี่ยวข้อง

• ทำไมคุณไม่ควรใช้text/htmlJSON
• บางครั้ง Internet Explorer มีปัญหา application/json
• รายการ Mimetypes ที่ค่อนข้างสมบูรณ์และสิ่งที่ควรใช้
• รายการประเภท mime อย่างเป็นทางการที่ IANAจากคำตอบของ @ gnrfan ด้านล่าง

IANAได้จดทะเบียนอย่างเป็นทางการสำหรับประเภท MIME JSON application/jsonเป็น

เมื่อถูกถามเกี่ยวกับสาเหตุที่ไม่ได้text/json, ครอกดูเหมือนว่าจะได้กล่าว JSON ไม่ได้จริงๆ JavaScript มิได้ข้อความและยัง IANA ก็มีแนวโน้มที่จะมือออกกว่าapplication/*text/*

แหล่งข้อมูลเพิ่มเติม:

• ประเภทสื่อ
• ขอความคิดเห็น 4627
• bluesmoon: JSON มีประเภท

สำหรับ JSON:

Content-Type: application/json

สำหรับJSON-P :

Content-Type: application/javascript

แน่นอนประเภทสื่อ MIME ที่ถูกต้องสำหรับ JSON คือapplication/jsonแต่จำเป็นต้องตระหนักถึงชนิดของข้อมูลที่คาดไว้ในแอปพลิเคชันของคุณ

ตัวอย่างเช่นฉันใช้Ext GWTและการตอบกลับของเซิร์ฟเวอร์จะต้องเป็นข้อความ / htmlแต่มีข้อมูล JSON

ฝั่งไคลเอ็นต์ฟังฟอร์ม Ext GWT

uploadForm.getForm().addListener(new FormListenerAdapter()
{
    @Override
    public void onActionFailed(Form form, int httpStatus, String responseText) 
    {
        MessageBox.alert("Error");
    }

    @Override
    public void onActionComplete(Form form, int httpStatus, String responseText) 
    {
        MessageBox.alert("Success");
    }
});

ในกรณีที่ใช้ชนิดการตอบกลับของแอปพลิเคชัน / jsonเบราว์เซอร์แนะนำให้ฉันบันทึกไฟล์

ข้อมูลโค้ดฝั่งเซิร์ฟเวอร์ใช้Spring MVC

return new AbstractUrlBasedView() 
{
    @SuppressWarnings("unchecked")
    @Override
    protected void renderMergedOutputModel(Map model, HttpServletRequest request,
                                           HttpServletResponse response) throws Exception 
    {
        response.setContentType("text/html");
        response.getWriter().write(json);
    }
};

JSON:

การตอบสนองคือข้อมูลที่สร้างขึ้นแบบไดนามิกตามพารามิเตอร์การค้นหาที่ส่งผ่านใน URL

ตัวอย่าง:

{ "Name": "Foo", "Id": 1234, "Rank": 7 }

ชนิดของเนื้อหา: application/json

JSON-P:

JSON พร้อมช่องว่างภายใน การตอบสนองคือข้อมูล JSON โดยมีการเรียกใช้ฟังก์ชันล้อมรอบ

ตัวอย่าง:

functionCall({"Name": "Foo", "Id": 1234, "Rank": 7});

ชนิดของเนื้อหา: application/javascript

หากคุณใช้ Ubuntu หรือ Debian และให้บริการไฟล์. json ผ่าน Apache คุณอาจต้องการแสดงไฟล์ที่มีประเภทเนื้อหาที่ถูกต้อง ฉันทำสิ่งนี้เป็นหลักเพราะฉันต้องการใช้ส่วนขยายของ Firefox JSONView

โมดูล Apache mod_mimeจะช่วยให้ทำสิ่งนี้ได้อย่างง่ายดาย อย่างไรก็ตามด้วย Ubuntu คุณต้องแก้ไขไฟล์/etc/mime.typesและเพิ่มบรรทัด

application/json json

จากนั้นรีสตาร์ท Apache:

sudo service apache2 restart

หากคุณกำลังเรียกใช้บริการเว็บ ASP.NET จากฝั่งไคลเอนต์คุณต้องใช้application/jsonเพื่อให้การทำงาน ฉันเชื่อว่านี่เป็นสิ่งเดียวกันสำหรับjQueryและกรอบงานExt

ประเภทเนื้อหาที่เหมาะสมสำหรับ JSON คือapplication/jsonถ้าคุณกำลังใช้JSONPยังเป็นที่รู้จัก JSON กับ padding ที่เป็นจริงเพื่อให้ JavaScript application/javascriptและประเภทของเนื้อหาที่เหมาะสมจะเป็น

ไม่ต้องสงสัยเลยว่าapplication/jsonเป็นประเภทMIME ที่ดีที่สุดสำหรับการตอบสนอง JSON

แต่ฉันมีประสบการณ์บางอย่างที่ฉันต้องใช้application/x-javascriptเพราะปัญหาการบีบอัดบางอย่าง สภาพแวดล้อมในพื้นที่ของฉันคือการร่วมกันพื้นที่กับGoDaddy พวกเขาไม่อนุญาตให้ฉันเปลี่ยนการกำหนดค่าเซิร์ฟเวอร์ ฉันเพิ่มรหัสต่อไปนี้ลงในweb.configไฟล์เพื่อบีบอัดคำตอบ

<httpCompression>
    <scheme name="gzip" dll="%Windir%\system32\inetsrv\gzip.dll"/>
    <dynamicTypes>
        <add mimeType="text/*" enabled="true"/>
        <add mimeType="message/*" enabled="true"/>
        <add mimeType="application/javascript" enabled="true"/>
        <add mimeType="*/*" enabled="false"/>
    </dynamicTypes>
    <staticTypes>
        <add mimeType="text/*" enabled="true"/>
        <add mimeType="message/*" enabled="true"/>
        <add mimeType="application/javascript" enabled="true"/>
        <add mimeType="*/*" enabled="false"/>
    </staticTypes>
</httpCompression>
<urlCompression doStaticCompression="true" doDynamicCompression="true"/>

ด้วยการใช้สิ่งนี้เพจ. aspx ถูกบีบอัดด้วย g-zip แต่การตอบสนอง JSON ไม่ได้ ฉันเพิ่ม

<add mimeType="application/json" enabled="true"/>

ในส่วนประเภทคงที่และแบบไดนามิก แต่สิ่งนี้จะไม่บีบอัดการตอบสนองของ JSON เลย

หลังจากนั้นฉันลบประเภทที่เพิ่มใหม่นี้และเพิ่ม

<add mimeType="application/x-javascript" enabled="true"/>

ในทั้งประเภทสแตติกและไดนามิกและเปลี่ยนประเภทการตอบกลับเป็น

.ashx (ตัวจัดการแบบอะซิงโครนัส) เป็น

application/x-javascript

และตอนนี้ฉันพบว่าการตอบสนอง JSON ของฉันถูกบีบอัดด้วย g-zip ดังนั้นฉันแนะนำให้ใช้เป็นการส่วนตัว

application/x-javascript

เฉพาะในกรณีที่คุณต้องการในการบีบอัดการตอบสนอง JSON ของคุณในสภาพแวดล้อมที่ใช้ร่วมกันพื้นที่ เนื่องจากในการโฮสต์ที่ใช้ร่วมกันพวกเขาไม่อนุญาตให้คุณเปลี่ยนการกำหนดค่าIIS

เฉพาะเมื่อใช้application/jsonเป็นชนิด MIMEฉันมีสิ่งต่อไปนี้ (จนถึงเดือนพฤศจิกายน 2011 กับ Chrome เวอร์ชันล่าสุด, Firefox พร้อมFirebug ):

• ไม่มีคำเตือนจาก Chrome อีกต่อไปเมื่อโหลด JSON จากเซิร์ฟเวอร์
• Firebug จะเพิ่มแท็บในการตอบกลับซึ่งแสดงข้อมูล JSON ที่จัดรูปแบบคุณ หากประเภท MIME นั้นแตกต่างกันก็จะปรากฏเป็น 'เนื้อหาการตอบสนอง'

application/jsonทุกอย่างไม่ทำงานสำหรับชนิดเนื้อหา

หากคุณกำลังใช้ Ext JS<iframe>ส่งแบบฟอร์มการอัปโหลดไฟล์จะต้องทราบว่าการตอบสนองเซิร์ฟเวอร์ถูกแยกวิเคราะห์โดยเบราว์เซอร์ในการสร้างเอกสารสำหรับ

หากเซิร์ฟเวอร์กำลังใช้ JSON เพื่อส่งวัตถุส่งคืนContent-Typeจะต้องตั้งค่าส่วนหัวไว้text/htmlเพื่อบอกให้เบราว์เซอร์แทรกข้อความที่ไม่เปลี่ยนแปลงลงในเนื้อหาเอกสาร

ดูExt JS เอกสาร

JSON เป็นภาษาเฉพาะโดเมน (DSL) และรูปแบบข้อมูลที่เป็นอิสระของ JavaScript และเป็นเช่นนี้มีของตัวเองไมม์application/jsonชนิด เคารพชนิด MIME เป็นลูกค้าแน่นอนขับเคลื่อนดังนั้นtext/plainอาจจะทำสำหรับการถ่ายโอนของไบต์ แต่แล้วคุณจะได้รับการผลักดันขึ้นตีความไปยังโดเมนการประยุกต์ใช้ผู้ขายไม่จำเป็น application/json- คุณจะถ่ายโอน XML ผ่านทางtext/plain?

แต่ตามจริงแล้วตัวเลือกประเภท MIME ของคุณเป็นคำแนะนำสำหรับลูกค้าเกี่ยวกับวิธีการตีความข้อมูล - text/plainหรือtext/HTML(เมื่อไม่ใช่ HTML) เหมือนกับการลบประเภท - มันไม่แปลกใหม่เหมือนกับการทำให้วัตถุประเภทวัตถุทั้งหมดเป็นภาษาที่พิมพ์

ไม่มีเบราว์เซอร์รันไทม์ที่ฉันรู้ว่าจะใช้เอกสาร JSON และทำให้มันพร้อมใช้งานโดยอัตโนมัติในฐานะที่เป็นออบเจ็กต์ที่สามารถเข้าถึงได้ JavaScript โดยไม่มีการแทรกแซง แต่ถ้าคุณทำงานกับไคลเอนต์ที่พิการนั่นเป็นเรื่องที่แตกต่างอย่างสิ้นเชิง แต่นั่นไม่ใช่เรื่องราวทั้งหมด - บริการ JSON RESTfulมักไม่มี JavaScript runtimes แต่มันไม่ได้หยุดพวกเขาโดยใช้ JSON เป็นรูปแบบการแลกเปลี่ยนข้อมูลที่ทำงานได้ หากลูกค้าเป็นคนพิการ ... ฉันจะพิจารณาการฉีด HTML ผ่านทางบริการอาแจ็กซ์เทมเพลตแทน

แอพลิเคชัน / JSON!

หากคุณอยู่ในสภาพแวดล้อมฝั่งไคลเอ็นต์การตรวจสอบการสนับสนุนข้ามเบราว์เซอร์เป็นสิ่งจำเป็นสำหรับเว็บแอปพลิเคชันที่ได้รับการสนับสนุนเป็นอย่างดี

HTTP ขวาชนิดเนื้อหาจะapplication/jsonเป็นคนอื่นที่ไฮไลต์อยู่แล้วด้วย แต่ลูกค้าบางคนไม่ได้จัดการกับมันได้เป็นอย่างดีว่าทำไม jQuery text/htmlแนะนำเริ่มต้น

คำตอบที่ถูกต้องคือ:

Content-Type: application/json

อย่างที่คนอื่น ๆ พูดถึงapplication/jsonนั่นคือคำตอบที่ถูก

แต่สิ่งที่ยังไม่ได้อธิบายก็คือตัวเลือกอื่น ๆ ที่คุณเสนอหมายถึงอะไร

• application/x-javascript: ประเภท MIME แบบทดลองสำหรับ JavaScript ก่อนapplication/javascriptสร้างมาตรฐาน

• text/javascript: ล้าสมัยแล้ว คุณควรใช้application/javascriptเมื่อใช้จาวาสคริปต์

• text/x-javascript: ประเภท MIME แบบทดลองสำหรับสถานการณ์ด้านบน

• text/x-json: ประเภท MIME ทดลองสำหรับ JSON ก่อนapplication/jsonลงทะเบียนอย่างเป็นทางการ

สรุปเมื่อใดก็ตามที่คุณมีข้อสงสัยเกี่ยวกับประเภทเนื้อหาคุณควรตรวจสอบลิงค์นี้

ในJSPคุณสามารถใช้สิ่งนี้ในหน้าสั่ง:

<%@ page language="java" contentType="application/json; charset=UTF-8"
    pageEncoding="UTF-8"%>

ที่ถูกต้องMIMEประเภทสื่อ JSON application/jsonคือ JSP จะใช้เพื่อส่งคำตอบไปยังลูกค้า

“ application/json” เป็นประเภทเนื้อหา JSON ที่ถูกต้อง

def ajaxFindSystems = {
  def result = Systems.list()
  render(contentType:'application/json') {
    results {
      result.each{sys->
        system(id:sys.id, name:sys.name)
      }
    }
    resultset (rows:result.size())
  }
}

การลงทะเบียนของ IANA สำหรับapplication/jsonพูดว่า

แอปพลิเคชันที่ใช้สื่อประเภทนี้: JSON ถูกใช้เพื่อแลกเปลี่ยนข้อมูลระหว่างแอปพลิเคชันที่เขียนในภาษาการเขียนโปรแกรมเหล่านี้ทั้งหมด: ActionScript, C, C #, Clojure, ColdFusion, Common Lisp, E, Erlang, Go, Java, JavaScript, Lua CAML, Perl, PHP, Python, Rebol, Ruby, Scala และ Scheme

คุณจะสังเกตเห็นว่า IANA.org ไม่ได้ระบุประเภทสื่ออื่น ๆ เหล่านี้อันที่จริงแม้ในapplication/javascriptปัจจุบันจะล้าสมัยแล้ว ดังนั้นจึงapplication/jsonเป็นคำตอบที่ถูกต้องเท่านั้นที่เป็นไปได้

การสนับสนุนเบราว์เซอร์เป็นอีกสิ่งหนึ่ง

ได้รับการสนับสนุนอย่างกว้างขวางที่สุดที่ไม่ได้มาตรฐานประเภทสื่อหรือtext/json แต่บางชื่อใหญ่ได้ใช้text/javascripttext/plain

แม้แปลกมากก็คือส่วนหัวของเนื้อหาชนิดที่ส่งมาจาก Flickr, text/xmlที่กลับเป็น Google ใช้text/javascriptสำหรับ ajax apis บางตัว

ตัวอย่าง:

curl -I "https://ajax.googleapis.com/ajax/services/search/video?v=1.0&q=jsonexample"

เอาท์พุท: Content-Type: text/javascript

curl -I "https://www.flickr.com/services/rest/?method=flickr.test.echo&format=json&api_key=f82254c1491d894f1204d8408f645a93"

เอาท์พุท: Content-Type: text/xml

ประเภท MIME ที่ถูกต้องคือ application/json

แต่

ฉันประสบกับสถานการณ์มากมายที่ประเภทเบราว์เซอร์หรือผู้ใช้เฟรมเวิร์กต้องการ:

text/html

application/javascript

ฉันใช้ด้านล่าง

contentType: 'application/json',
data: JSON.stringify(SendData),

ชนิดเนื้อหาส่วนหัวควรจะกำหนดให้ ' application / JSON ' โพสต์เมื่อ การฟังเซิร์ฟเวอร์สำหรับคำขอควรมี " Accept = application / json " ใน Spring MVC คุณสามารถทำสิ่งนี้ได้:

@RequestMapping(value="location", method = RequestMethod.POST, headers = "Accept=application/json")

เพิ่มส่วนหัวในการตอบกลับ:

HttpHeaders headers = new HttpHeaders();
headers.add("Content-Type", "application/json");

ในฤดูใบไม้ผลิคุณมีกำหนดชนิด: MediaType.APPLICATION_JSON_VALUEซึ่งเทียบเท่ากับแอพลิเคชัน / JSON

ใช้application/jsonงานได้ดีใน PHP เพื่อเก็บข้อมูลอาเรย์หรือวัตถุ

ฉันใช้รหัสนี้เพื่อใส่ข้อมูลใน JSON บนGoogle Cloud Storage (GCS)ซึ่งตั้งค่าให้ดูแบบสาธารณะ :

$context = stream_context_create([
    'gs' => [
        'acl'=>'public-read', 
        'Content-Type' => 'application/json',
    ]
]);

file_put_contents(
    "gs://BUCKETNAME/FILENAME.json", 
    json_encode((object) $array), 
    false, 
    $context
);

หากต้องการรับข้อมูลกลับคืนจะต้อง:

$data = json_decode(file_get_contents("gs://BUCKETNAME/FILENAME.json"));

หาก JSON นั้นมีการเติมเต็มมันจะเป็นapplication/jsonpเช่นนั้น หาก JSON ไม่มีการเติมเต็มมันจะเป็นapplication/jsonเช่นนั้น

ในการจัดการกับทั้งสองวิธีนี้เป็นวิธีปฏิบัติที่ดีในการใช้: 'application / javascript' โดยไม่ต้องกังวลว่าจะมีช่องว่างภายในหรือไม่มีช่องว่างภายใน

สำหรับ JSON ฉันใช้:

 Content-Type: application/json

นี้จะอธิบายใน IETF ของ JSON Data Interchange Format 7158 ข้อเสนอมาตรา 1.2: ข้อมูลจำเพาะของ JSON

การขยายการตอบกลับที่ยอมรับเมื่อคุณใช้ JSON ในบริบท REST ...

มีข้อโต้แย้งเกี่ยวกับการใช้application/x-resource+jsonและapplication/x-collection+jsonเมื่อคุณแสดงถึงทรัพยากรและคอลเลกชัน REST

และหากคุณตัดสินใจที่จะปฏิบัติตามข้อกำหนดjsonapi คุณควรใช้application/vnd.api+jsonเนื่องจากเป็นเอกสาร

ไม่มีมาตรฐานสากลเป็นที่ชัดเจนว่าความหมายที่เพิ่มเข้ากับทรัพยากรที่ถูกถ่ายโอนจัดชิดขอบประเภทเนื้อหาที่ชัดเจนยิ่งกว่าapplication/jsonมากกว่าเพียงแค่

ต่อไปนี้เหตุผลนี้บริบทอื่น ๆ สามารถปรับขึ้นเฉพาะเนื้อหาชนิด

นักพัฒนา PHP ใช้สิ่งนี้:

<?php
    header("Content-type: application/json");

    // Do something here...
?>

หากคุณได้รับข้อมูลจาก REST API ใน JSON คุณต้องใช้ประเภทเนื้อหา

For JSON data: Content-Type:application/json
For HTML data: Content-Type:text/html,
For XHTML data: Content-Type:application/xhtml+xml,
For XML data: Content-Type:text/xml, application/xml

Content-Type: application/json- json
Content-Type: application/javascript- json-P
Content-Type: application/x-javascript- javascript
Content-Type: text/javascript- javascript แต่ล้าสมัยรุ่น IE ที่เก่ากว่าใช้ในการใช้เป็นแอตทริบิวต์ html
Content-Type: text/x-javascript- ประเภทสื่อ JavaScript แต่เลิกใช้แล้ว
Content-Type: text/x-json- json ก่อนสมัคร / json ได้ลงทะเบียนอย่างเป็นทางการแล้ว

รูปแบบ JSON (JavaScript Object Notation) และJSONP ("JSON with padding") ดูเหมือนว่าจะคล้ายกันมากและดังนั้นจึงอาจทำให้เกิดความสับสนอย่างมากว่า MIME ชนิดใดที่ควรใช้ แม้ว่ารูปแบบจะคล้ายกัน แต่ก็มีความแตกต่างเล็กน้อยระหว่างรูปแบบเหล่านี้

ดังนั้นเมื่อใดก็ตามที่มีข้อสงสัยฉันมีวิธีการที่ง่ายมาก (ซึ่งใช้ได้ดีในกรณีส่วนใหญ่) คือไปและตรวจสอบเอกสาร RFC ที่เกี่ยวข้อง

JSON RFC 4627 (ประเภทสื่อของแอปพลิเคชัน / json สำหรับสัญลักษณ์วัตถุ JavaScript (JSON)) เป็นข้อกำหนดของรูปแบบ JSON มันบอกว่าในส่วนที่ 6 ว่าไมม์ชนิดของสื่อสำหรับข้อความ JSON คือ

application/json.

JSONP JSONP ("JSON with padding") ได้รับการจัดการในลักษณะที่แตกต่างจาก JSON ในเบราว์เซอร์ JSONP ถือเป็นสคริปต์ JavaScript ปกติดังนั้นจึงควรใช้application/javascript,ประเภท MIME ปัจจุบันอย่างเป็นทางการสำหรับ JavaScript อย่างไรก็ตามในหลายกรณีtext/javascriptMIME type ก็จะทำงานได้ดีเช่นกัน

โปรดทราบว่าtext/javascriptได้รับการทำเครื่องหมายว่าล้าสมัยโดยเอกสารRFC 4329 (ประเภทสื่อสคริปต์) และแนะนำให้ใช้application/javascriptประเภทแทน อย่างไรก็ตามเนื่องจากเหตุผลดั้งเดิมtext/javascriptยังคงใช้กันอย่างแพร่หลายและมีการสนับสนุนข้ามเบราว์เซอร์ (ซึ่งไม่ใช่กรณีที่มีapplication/javascriptประเภท MIME โดยเฉพาะกับเบราว์เซอร์รุ่นเก่า)