Limity stawek interfejsu Web serwisu Spotify

Question

Dokumentacja interfejsu API Spotify Web wskazuje limity stawek. Na przykład: authorization guide mówi:

Dostęp do punktów końcowych, do których nie ma dostępu do informacji użytkownika. Jego zaletą jest to, że wyższy limit stawki jest stosowany w porównaniu do żądań do Web API wykonanych bez tokena dostępu.

Czy limity stawek są czymś, o czym ja, jako programista, muszę się martwić? Czy zgłoszenie do interfejsu API sieci Web zakończy się niepowodzeniem, jeśli przekroczę limit stawki, a jeśli tak, to jak będzie wyglądać awaria?

Z góry dziękuję.

Answer 1

Znajdziesz ogólne informacje na temat ograniczenia stawki w User Guide. Jak opisano w artykule Status codes, interfejs Web API zwróci HTTP status code 429 (Too Many Requests), jeśli aplikacja zgłasza więcej żądań niż dozwolony limit.

W takim przypadku należy odczekać chwilę (patrz aktualizacja poniżej) przed ponownym wysłaniem żądania. Oczywiście najlepszą rzeczą do zrobienia jest próba uniknięcia osiągnięcia limitu stawki w pierwszej kolejności. Jak sugeruje podręcznik użytkownika, możesz to zrobić, na przykład uzyskując dostęp do wielu obiektów jednocześnie, które są dostępne dla niektórych punktów końcowych. Możesz także buforować odpowiedzi.

Aktualizacja: W przypadku ograniczenia stawki odpowiedź HTTP będzie zawierać nagłówek o nazwie "Ponów próbę". Wartość tego nagłówka to ilość sekund, które należy poczekać, aż do następnego żądania. Na przykład: Retry-After: 4 oznacza, że ​​musisz poczekać cztery sekundy, zanim spróbujesz ponownie. Jest to teraz również wspomniane w Web API User Guide.