2. Трудности
проектирования
API

3. api.sometaxi.ru
Партнеры
/request ➞
/status
/cancel ➞
Приложения
➞ /order
➞ /status
➞ /feedback
➞

4. client-api.sometaxi.ru
Партнеры
/request ➞
/status
/cancel ➞
Приложения
➞ /order
➞ /status
➞ /feedback
partner-api.sometaxi.ru
➞

5. client-api.sometaxi.ru
Партнеры
/2.1/request ➞
/2.1/status
/2.1/cancel ➞
Приложения
➞ /1.0/order
➞ /1.0/status
➞ /1.0/feedback
partner-api.sometaxi.ru
➞

6. 3.2.5

7. .../3.2/...

8. client-api.sometaxi.ru
/2.1/request ➞
/2.1/status
/2.1/cancel ➞
➞ /1.0/order
➞ /1.0/status
➞ /1.0/feedback
partner-api.sometaxi.ru
➞

9. client-api.sometaxi.ru
/2.1/request ➞
/2.1/status
/2.1/cancel ➞
➞ /1.0/order
➞ /1.0/status
➞ /1.0/feedback
partner-api.sometaxi.ru
➞
XML

10. <?xml version="1.0" encoding="utf-8">
<Order>
<From>
<Address>Хохрякова, 10</Address>
<DateTime>03.06.2013 12:00</DateTime>
</From>
...
</Order>
XML

11. <?xml version="1.0"?>
<soap:Envelope
xmlns:soap="http://www.w3.org/2001/12/soap-envelope"
soap:encodingStyle="http://www.w3.org/2001/12/soap-encoding">
<soap:Body xmlns:t="http://client-api.sometaxi.ru/xmlns">
<t:Order>
<t:From>
<t:Address>Хохрякова, 10</t:Address>
<t:DateTime>2013-06-03T12:00+0600</t:DateTime>
</t:From>
...
</t:Order>
</soap:Body>
</soap:Envelope>
XML

12. <?xml version="1.0"?>
<!DOCTYPE lolz [
<!ENTITY lol "lol">
<!ENTITY lol1 "&lol;&lol;&lol;&lol;&lol;&lol;&lol;&lol;&lol;&lol;">
<!ENTITY lol2 "&lol1;&lol1;&lol1;&lol1;&lol1;&lol1;&lol1;&lol1;&lol1;&lol1;">
<!ENTITY lol3 "&lol2;&lol2;&lol2;&lol2;&lol2;&lol2;&lol2;&lol2;&lol2;&lol2;">
<!ENTITY lol4 "&lol3;&lol3;&lol3;&lol3;&lol3;&lol3;&lol3;&lol3;&lol3;&lol3;">
<!ENTITY lol5 "&lol4;&lol4;&lol4;&lol4;&lol4;&lol4;&lol4;&lol4;&lol4;&lol4;">
<!ENTITY lol6 "&lol5;&lol5;&lol5;&lol5;&lol5;&lol5;&lol5;&lol5;&lol5;&lol5;">
<!ENTITY lol7 "&lol6;&lol6;&lol6;&lol6;&lol6;&lol6;&lol6;&lol6;&lol6;&lol6;">
<!ENTITY lol8 "&lol7;&lol7;&lol7;&lol7;&lol7;&lol7;&lol7;&lol7;&lol7;&lol7;">
<!ENTITY lol9 "&lol8;&lol8;&lol8;&lol8;&lol8;&lol8;&lol8;&lol8;&lol8;&lol8;">
]>
<lolz>&lol9;</lolz>
XML

13. {
"from": {
"address": "Хохрякова, 10",
"datetime": "2013-06-03T12:00+0600"
},
...
}
JSON

14. client-api.sometaxi.ru
/2.1/request ➞
/2.1/status
/2.1/cancel ➞
➞ /1.0/order
➞ /1.0/status
➞ /1.0/feedback
partner-api.sometaxi.ru
➞
XMLJSON

15. /2.1/request ➞
/2.1/status:driving
/2.1/cancel ➞
/2.1/status:cancelled
partner-api.sometaxi.ru
➞
200 OK
200 OK
200 OK
200 OK➞

16. /2.1/request ➞
/2.1/status:driving
/2.1/cancel ➞
/2.1/status:waiting
partner-api.sometaxi.ru
➞
200 OK
200 OK
request timeout
200 OK?➞

17. /2.1/request ➞
/2.1/status:driving
/2.1/cancel ➞
/2.1/cancel ➞
/2.1/cancel ➞
...
/2.1/status:waiting
/2.1/status:cancelled
partner-api.sometaxi.ru
➞
200 OK
200 OK
request timeout
request timeout
request timeout
...
410 Gone!
200 OK :)
➞
➞

18. {
"from": {
"city": "Москва",
"address": "Хохрякова, 10",
"datetime": "2013-06-03T12:00+0600"
},
"user": {
"name": "Алексей",
"phone": "+79001112233"
},
...
}
/1.0/order

19. {
"from": {
"city": "00001",
"address": "Хохрякова, 10",
"datetime": "2013-06-03T12:00+0600"
},
"user": {
"phone": "+79001112233"
},
...
}
/1.0/order

20. {
"from": {
"city": "00001",
"address": "Хохрякова, 10",
"datetime": "2013-06-03T12:00+0600"
},
"user": {
"name": "",
"phone": "+79001112233"
},
...
}
/1.0/order

21. {
"from": {
"city": "00001",
"address": "Хохрякова, 10",
"datetime": "2013-06-03T12:00+0600"
},
"user": {
"name": " ",
"phone": "+79001112233"
},
...
}
/1.0/order

22. Пользователь — не друг.
Умейте его банить.

23. Мелким
шрифтом
Используйте возможности протокола
gzip
keepalive
Пишите примеры использования
пример значения поля
пример целого запроса
пример целого приложения на популярном языке
Ведите подробные логи
•
–
–
•
–
–
–
•

25. Старший разработчик
Яндекс.Такси
alexkir@yandex-team.ru
beevee_ru
Спасибо
Алексей Кирпичников