Вашето мнение: Куриерско API

Ха честита Ви нова година драги колеги! Живи и здрави и двойно по-успешни проекти тази година. Но най-важното здраве за вас и вашите близки, другото ще го изкодите както се казва

Тъй като на повечето от вас ви се налага да работите с api-та на ежедневен принцип имам нужда от вашето мнение. Имам честта да изградя API за една от най-големите куриерски фирми. Въпреки това, мнението на един екип не е достатъчно при направата на такова творение. Именно заради това отправям апел към всички вас, които имате опит с консумацията на API-та. Какво бихте искали да има, кое би ви направило живота по-лесен при вграждането? Какви са вашите изисквания, без които не може да се съгласите да го импортвате? Мнението ви е важно! Въпреки, че аз ще се занимавам с „дизайна“ и поддръжката му не отказвам фийчър рикуести.

Заплануваното до тук:

• Три формата – xml, json, yaml.
• Опция само за калкулация на цена, при подаване на минимална информация, крайно необходима за калкулацията, но и с опция за подробно предоставяне на информация + допълнителни услуги и прочее.
• Запазване на товарителница.
• Извеждане на списък с всички имена на градове/пощенски кодове с офисите на куриерскта фирма.
• Проследяване на пратки.
• Връщане на грешки тип код на грешката и грешка в текст.
• Примери за вграждане под формата на библиотеки за: CakePHP (datasource), Zend Framework, Lithium, Symfony, CodeIgniter + чисто php.
• Изграждане на сайт, специално за api-то с опция за фиийдбек + изтегляне на документация + сваляне на библиотеките (които ще бъдат хостнати в github и спокойно ще може да ги fork-нете).

Предстои да бъде решено:

• Метод за ауторизация: oAuth vs. digest vs. basic auth вклюващ token и api-потребителско име vs. Cookie authorization (на принципа клиента пази бисквитка след първоначалната ауторизация и я подава при всяка една заявка)?
  Лично мнение: oAuth е доказно най-сигурния метод, но определено не е лесен за вграждане. Мисля, да се придържаме към нещо по-просто.
• SSL (може би за в бъдеще)?
• Грешки на български или ангийски?
  Лично мнение: английски
• Опция за регистрация на акунта в сайта през api-то?
• Изпращане на заявка за куриер директно през api-то?
• Модули/добавки за онлайн магазини? Ако да, за кои?
• Извличане на всички запазни, но не изпратени товарителници?

Всички коментари са добре дошли. Скоро ще пуснем и официален сайт в който ще можете да пишете своите коментари директно там, но за сега моля да бъдат писани в коментарите под публикацията.

Благодаря предварително за проявения ентусиазъм и професионалните мнения, които ще получа.