💆🏼 🏩 👎🏿 نصيحة سيئة لواجهة برمجة تطبيقات REST "المثالية" 👸🏽 🥜 🐢

مرحبا!

لماذا يكتب "المثالي" بين علامات الاقتباس ؟!

, " ", , — )

ربما قام الكثير منا بإنشاء واجهات برمجة تطبيقات REST ، أو استخدموا واجهات برمجة تطبيقات جاهزة لشخص آخر. دعنا نلقي نظرة على الحيل "المذهلة" التي ستساعدك على جعل واجهة برمجة التطبيقات الخاصة بك تتفوق على الآخرين.

حزام أبيض

جميع القيم في json هي سلسلة وليس غير ذلك!

حسنًا ، لنأخذ أبسط كائن:

{
  "stringValue" : "value",
  "intValue": 123
}

هذا هو السبب في 123 هنا لتحديد رقم ، لماذا هذا الالتباس؟ دعها تكون خيطًا ، سوف يكتشفها جهاز إزالة التسلسل:

{
  "stringValue" : "value",
  "intValue": "123"
}

, ? … ?

{
  "stringValue" : "value",
  "intValue": "123",
  "complexValue": {
    "key": "value"
  }
}

… ! -:

{
  "stringValue" : "value",
  "intValue": "123",
  "complexValue": "{
    \"key\": \"value\"
  }"
}

? ? , ? , !

{
  "stringValue" : "value",
  "intValue": "123",
  "complexValue": "{
    \"key\": \"value\",
    \"anotherComplexValue\": {
      \"superKey\": \"megaValue\"
    }
  }"
}

, ! ! !… ? ? , , . complexValue ? , , , , .

"Key": Value — , ...

2-3 , ? :

[
  25000, 
  "", 
  {
    "key1": "value1",
    "key2": "value2"
  }
]

! ? ! ? . , !

[
  25000, 
  "", 
  "{
    \"key1\": \"value1\",
    \"key2\": \"value2\"
  }"
]

! ! , , 5 :

[
  25000, 
  "",
  [
    "value1",
    "value2"
  ] 
]

! json , !

: — , ?

[
  "",
  "[
    \"value1\",
    \"value2\"
  ]",
  "25000"
]

? 3- ? , , , . ? 25000, , . ? ? — , !

. …

- . , , . :

{
  "queryType": "select",
  "table": "lyudi",
  "where": "name =  AND zarplata > 15000"
}

! ! ? , , )

, ?

, !

… ! :

{
  "query": "select * from lyudi where name =  AND zarplata > 15000"
}

! ? ? ? , . ORM? ? -. MSSQL .

""! -

: API ? : ! ! rest' . : , ! !

, , , "", , , , )

, api vpn , : .

- , ! -!

JSON

. , ! , - :

{}

{
  "key1": "value1",
  "key2": 2
}

{
  "key1": "value1",
  "key2": 2,
  "key3": {
    "123": 456
  }
}

, :

{
  "objectAsArray": ["Vasya", 123, 456, "Piter"]
}

! !

! JSON : VARCHAR(MAX). !

!

dbf, ? !

{
  "data": "Vasya     123  456  Piter                  "
}

10 , 5 , 5 , 20 . , ! , , !

!

— ? , , !

{
  "data": [56, 61, 73, 79, 61, 20, 20, 20, 20, 20, 31, 32, 33, 20, 20, 34, 35, 36, 20, 20, 50, 69, 74, 65, 72, 20, 20, 20, 20, 20, 20, 20, 20, 20, 20, 20, 20, 20, 20, 20, 20, 20, 20]
}

! :

{
  "data": "[56, 61, 73, 79, 61, 20, 20, 20, 20, 20, 31, 32, 33, 20, 20, 34, 35, 36, 20, 20, 50, 69, 74, 65, 72, 20, 20, 20, 20, 20, 20, 20, 20, 20, 20, 20, 20, 20, 20, 20, 20, 20, 20]"
}

, !

P.S. "" P.S. ...

إذا بدا لك أن المؤلف يبالغ ويخترع ، إذن ... يريد المؤلف أن يكون كذلك. ومع ذلك ، كان علي التعامل مع كل من هذه الحالات. دعونا نحترم بعضنا البعض ونفعل الخير ، وليس بعض الهراء) شكرا لاهتمامكم ، وآمل في بعض الأماكن لم يكن حزينا فقط ، ولكن أيضا ممتع!

نصيحة سيئة لواجهة برمجة تطبيقات REST "المثالية"